/parcel-react-ssr

Example of server-rendering with React.js and ParcelJS

Primary LanguageJavaScriptMIT LicenseMIT

parcel-react-ssr

Simple example of how to do server-rendering. You will not believe how easy it is!

Using:

  • parcel-bundler
  • react
  • react-router-dom
  • react-helmet (SEO)

How to run

  • npm run dev - Run the development server with hot reload but no server-rendering
  • npm run build - Build for production, required before running
  • npm start - Start the production server

How does it work?

To do proper server-rendering, the code is bundled in two version: one for the browser and one for Node.js.

The browser version is in the dist/client folder and the Node.js version is in dist/server. However, they both share the same public path for their files: /dist and it points to the browser version. Go read the code, it's pretty straightforward!

Read the code!

  1. package.json - Start by reading the scripts section to understand how the build process works. Yes it's that dead simple!
  2. app/index.html - Your only HTML file acting as a template
  3. app/client.js - Entry point for your browser version
  4. app/App.jsx - Your main application component shared between your browser and Node.js version
  5. app/HelloWorld.jsx - Dead simple hello world
  6. app/HelloWorld.scss - Example of SCSS
  7. server/index.js - Entry point for your Node.js version
  8. server/middleware.js - Middleware taking care of server-rendering
  9. server/generateHtml.js - Generate the HTML using index.html as the template with cheerio