Skip to content
This repository has been archived by the owner on Apr 30, 2021. It is now read-only.

Latest commit

 

History

History

Getting-Started

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
README.md
README.md
 
 

README.md

Getting Started

"We are no better than no one, We are not in competition with anyone, We want to be the best version of ourselves."

welcome. this is documentation of RSSR (React Server Side Rendering) Boilerplate.

What is RSSR

RSSR is React Server Side Rendering biolerplate that helps you creat SSR React apps easier than any time.

Features

RSSR is a SSR boilerplate for React js which contains:

  • SSR (Server Side Rendering)
  • User Authentication Structure
  • SEO optimization utilities
  • SCSS Style Namespace
  • and more …

Usage Tips

  • Run commands at root of project.

Quick start

  • Make sure that you have Node.js v10.13.0 and npm v6 or above installed.
  • Clone repo using git clone https://github.com/rssr-org/RSSR.git <YOUR_PROJECT_NAME>
  • Move to your local directory: cd <YOUR_PROJECT_NAME>
  • Select one of the following instructions based on your environment

Run in Development mode

  1. Run npm i (install npm packages).
  2. Run npm run dev in other next terminal (start running project in development mode).
  3. Stay for initial build to be able to see App overlocalhost:8000 (App will be opened in browser automatically).

Remove Fake API

In the real project you must remove fakeApi.

  1. Go to ~/provider/server/development.js, find require('../setup/fakeApi')(app) and remove it.
  2. Go to ~/provider/setup and remove fakeApi.js file.
  3. Change API_HOST_IN_CLIENT and API_HOST_IN_SERVER in .env file.

Run in Production mode

  1. Pull changes from Git.
  2. Run npm i (install npm packages).
  3. Run npm run build (building the project and inject it in to /dist directory at root of project).
  4. Run one of the following commands.

Initial Start:

  • npm run start for starting the project by nodejs runner (recommended for testing production).
  • npm run start-pm2-low for starting the project by pm2 tools and run production server over one core of CPU.
  • npm run start-pm2 is like npm run start-pm2-low but it runs over all CPU core. (learn more about it in PM2 cluster) (recommended for main production)

Updating

  • npm run up-low, mix of delete available process and npm run start-pm2-low (once CPU core)
  • npm run up,like npm run up-low but over all CPU core (recommended for main production)

Read Everything About RSSR: Document