https://github.com/adarshsingh1407/neo-cra
Boiler-plate code for server-rendered(SSR), progressive web app(PWA) in React
https://github.com/adarshsingh1407/neo-cra
babel babel-es6 boilerplate code-splitting express express-js lazy-loading progressive-web-app react react-intl react-router react-router-dom react-router-redux react-router-v4 react16 redux server-side-rendering
Last synced: 17 days ago
JSON representation
Boiler-plate code for server-rendered(SSR), progressive web app(PWA) in React
- Host: GitHub
- URL: https://github.com/adarshsingh1407/neo-cra
- Owner: adarshsingh1407
- Created: 2017-11-01T08:02:54.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-12-04T06:38:25.000Z (over 7 years ago)
- Last Synced: 2025-03-28T14:21:23.668Z (about 1 month ago)
- Topics: babel, babel-es6, boilerplate, code-splitting, express, express-js, lazy-loading, progressive-web-app, react, react-intl, react-router, react-router-dom, react-router-redux, react-router-v4, react16, redux, server-side-rendering
- Language: JavaScript
- Homepage:
- Size: 2.99 MB
- Stars: 11
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# NEO-CRA
This project was bootstrapped with [Create React App](https://github.com/facebookincubator/create-react-app)
> Stack
| S.NO. | PACKAGE |
| ---: | :--- |
| 1 | React 16 |
| 2 | React-Router 4 |
| 3 | Express 4 |
| 4 | React-Helmet |
| 5 | Redux |
| 6 | Axios |
| 7 | Universal-Cookie |
| 8 | React-Intl |
---
> Branch Description
| BRANCH | DESCRIPTION |
| ---: | :--- |
| master | Async SSR, Redux, Internationalization |
| static-ssr | Static SSR Implemented |
| async-ssr | Async SSR Implemented |
---
> Terminal Commands
| TASK | COMMAND |
| ---: | :--- |
| DEV_MODE | yarn start |
| BUILD_DEV | yarn build:dev |
| BUILD_PROD | yarn build:prod |
| BABELIFY | yarn babelify |
| TEST | yarn test |
| SERVE_PROD | pm2 start ecosystem.config.js --env production |
| SERVE_DEV | pm2 start ecosystem.config.js |
| EJECT_APP | yarn eject |
---
1. Before starting the project, redux store structure for the app needs to be thought of so that it can cater to all pages and maximum use cases.
---
2. ENV
a. REACT_APP_ENV is given while building the app - For Browser ENV
b. Also, while starting the app on server(at runtime) - For Server ENV
---
3. Managing Access Tokens
a. Import cookie instance from CookiesProvider wherever tokens need to be set/reset, i.e., login/logout
b. For making API calls or restricting routes with accesstoken, get the apiContext from ApiContextProvider
---
4. Sanity Checks
a. App build is running fine
b. SSR is running properly
---
5. I18N
a. React-Intl has been used for I18N.
IntlProvider is wrapped around the App on server-side(serverRender) and client-side(src/index).
b. On client-side, locale is fetched from navigator languages
On server-side, locale is fetched from accepted-language in header of the request
[Ref. localeMsgs]
c. Adding Locale
Add file to locales folder and add case to localeMsgs.js
d. If explicit widget is required to change preferred language, set it in a cookie and handle it in getLocale of localeMsgs
e. Translations Manager
[babel-plugin-react-intl](https://github.com/yahoo/babel-plugin-react-intl) currently helps spit out all the translations(for Translators) used in the app. If you want this to be in one file, use [React-intl-translations-manager](https://github.com/GertjanReynaert/react-intl-translations-manager) for managing translations. It has other powerful options too, if you want to explore.
---
6. Code-splitting and Lazy Loading
NOTE: Don't OVERDO it!
a. Codes-splitting has been achieved by using [dynamic imports](http://2ality.com/2017/01/import-operator.html#loading-code-on-demand), which is provided by default through [CRA](https://github.com/facebookincubator/create-react-app/blob/master/packages/react-scripts/template/README.md#code-splitting).
b. AsyncComponent will provide you with a function(asyncComponent) to dynamically import Components in your modules/components.
c. Lazy Loading: Dynamically import Components using above-mentioned function wherever required for lazy-loading of modules/components.
d. Working example available in `code-splitting` branch. Please refer components/AsyncComponent, src/App and components/Protected.
---
> TO-DO
- [ ] Code-splitting + SSR
- [ ] HMR with SSR
---