react-pwa-reference's Introduction

react-pwa-reference

A project boilerplate and reference example for ~~isomorphic~~ universal reactiflux progressive web applications.

Summary

This project is an evolution of flux-react-example and flux-react-example-sw that adds evolved tooling and organization. It's a rather complete, performance minded reference PWA that uses data-driven routes and content from an attached service.

Environment Prerequisites

Just Node. Node >= 4 LTS, recommend 6, nvm

Stack

Node
Express
React (Facebook)
Fluxible (Yahoo)
sw-toolbox, sw-precache (Google)
babel6, gulp4, webpack, eslint, mocha/chai, sass

Setup

git clone https://github.com/localnerve/react-pwa-reference
npm install

Run

Run Production

npm run build:server && npm start

Run Development

npm run dev

Development Tasks

command	description
`npm run build:list`	dump the asset build task tree to console
`npm run config:dev`	dump the development config to console
`npm run config:prod`	dump the production config to console
`npm run dev`	lint, build assets, start the server, verbose, NODE_ENV=development
`npm run dev:analyze`	analyze webpack stats file and dump bundle size analysis to console
`npm run dev:ccss`	build css assets, watch and recompile sass on change
`npm run dev:debug`	lint, build assets, start/debug server, NODE_ENV=development, wait debugger attach
`npm run dev:perf`	lint, build assets, scripts w/source maps, start server, NODE_ENV=production
`npm run dev:prod`	lint, build assets, start server, NODE_ENV=production
`npm run fixtures:dev`	build test fixtures from data service, development
`npm run fixtures:prod`	build test fixtures from data service, production
`npm run lint`	run linter on entire project
`npm run perfbudget`	used by CI to test performance budget against service
`npm run test`	run the entire test suite
`npm run test:cover`	run the entire test suite, capture coverage, and report
`npm run test:debug`	build with source maps, start the test suite, wait debugger attach
`npm run test:func`	used by CI to run functional tests against selenium grid

Recommend Projects