matmunn / parcel-react-ssr

Example of server-rendering with React.js and ParcelJS

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)
• react-imported-component (Code Splitting)

Handy Extras

• gzip compression
• eslint
• favicon example
• Code split example

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/HelloWorld2.jsx - A fun code split example
7. app/HelloWorld.scss - Example of SCSS
8. server/index.js - Entry point for your Node.js version
9. server/middleware.js - Middleware taking care of server-rendering
10. server/generateHtml.js - Generate the HTML using index.html as the template with cheerio