Skip to content

Firebase Cloud Functions React SSR ready boilerplate with Code Spliting, CSS Modules and Offline Support

License

Notifications You must be signed in to change notification settings

flasd/fireplate

Repository files navigation

FirePlate

get it?

React SSR app boilerplate made to work with Firebase Cloud Functions with Code Spliting, SCSS Modules and Offline Support!

Build Status Coverage Status license code style

What does this offer, you ask? 🔥

  • ES6, 7, NEXT Support with Babel
  • Webpack Bundling
  • Service Worker and Offline Support
  • Server Side Rendering
  • Code Spliting and Dynamic Imports
  • SCSS Modules & PostCss post-processing
  • NYC, Mocha & Chai for testing

Quick Start

This needs Nodejs v6.12.3 or latter!

First, as you might expect, just clone this repo:

$ git clone https://github /flasd/fireplate.git nextBigThing

Now cd to nextBigThing and run

$ sudo npm install firebase-tools -g && npm run setup
...

This will pretty much do all the setup for you. Now just

$ npm start

And remember, have fun!

Entry for the SSR app issrc/index.jsand entry for the browser app issrc/app/index.js.

Caveat

DLL build will fail when any of the dependencies depend on NodeJs's core modules.

Example: Let's assume you are adding express to your project. Express depends on NodeJs's modules. To make the project build, openwebpack/dll.config.jsand add 'express' to the exclude array.

Tips

Critical Path (s)Css

There are two SCSS loaders, the regular one configured to leave the css inside the component's Js module and the critical path one, configured to inline the css into the index.html template used to render the app.

Examples:
myStyles.scss - Regular CSS, will be injected when component loads.
myStyles.critical.scss - Critical path CSS, will be inlined inside index.html

Testing

This boilerplate comes with Mocha, Chai, Enzime, NYC and the Babel Rewire plugin to help you better test your code. You can write your tests in full ES6 glory! Plus, it uses eslint to lint your code, making sure you keep up with good practices!

To test:$ npm test To lint:$ npm run lint

Building & Deploying

To build your project to a production build, just run

$ npm run build

To checkout your built app running in a similiar environment as when you deploy it to Firebase, you can

$ npm run serve

Deploying your code to Firebase is as simple as building, assuming you completed the setup correctly. Just

$ npm run deploy

Done. That easy. 🍰

"For my part I know nothing with any certainty, but the sight of the stars makes me dream." Vincent Van Gogh

😉⭐

Licence

MIT Licenceall the way! Let's make something awesome! 🚀

About

Firebase Cloud Functions React SSR ready boilerplate with Code Spliting, CSS Modules and Offline Support

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published