React and Redux, Webpack 2 boilerplate

Table of contents

• What is this?
• Features
• Setup
• Running in dev mode
• Build (production)
• Running in preview production mode
• Linting
• Git hooks
• Changelog

What is this?

Boilerplate I extracted from a small real world project.

Webpack 2 is still in beta, but at this point is the only version that I managed to run everything I wanted, including hot module replacement.

This boilerplate includes complete, minimal react app. By complete I mean it has examples for:

• components (both container/views and regular ones)
• routes
• reducers (redux)
• actions (both sync and async),
• SASS (with autoprefixer)¹
• dummy API
• using assets (in CSS and components)
• imports relative to the app root

¹ Using source maps breaks urls in the CSS loader - webpack-contrib/css-loader#232. Try this to fix it (but it breaks testing from local network).

Features

• React
• React router
• Redux
• Redux Thunk
• Redux Dev Tools
• Immutable reducer data
• Webpack 2 (development and production config)
• Hot Module Replacement
• Babel - static props, decorators
• SASS with autoprefixing
• Webpack dashboard
• Linting
• Included es6-promise and isomorphic-fetch
• Preview production build
• File imports relative to the app root
• Git hooks - lint before push

Universal may be added at some point.

• Universal rendering
• Server async data

Other nice to have features

• Generating icon font from SVGs
• Modernizr
• Google analytics
• Error reporting (not sure if this should be the part of the boilerplate)

Setup

Tested with node 6.x and 7.x

$ npm install

Running in dev mode

$ npm start

Visit http://localhost:3000/ from your browser of choice. Server is visible from the local network as well.

It is using webpack dashboard, so please note the following:

OS X Terminal.app users: Make sure that View → Allow Mouse Reporting is enabled, otherwise scrolling through logs and modules won't work. If your version of Terminal.app doesn't have this feature, you may want to check out an alternative such as iTerm2.

Build (production)

Build will be placed in the build folder.

$ npm run build

If your app is not running on the server root you should change publicPath at two places.

In webpack.config.js (ATM line 147):

output: {
  path: buildPath,
  publicPath: '/your-app/',
  filename: 'app-[hash].js',
},

and in source/js/routes (ATM line 9):

const publicPath = '/your-app/';

Don't forget the trailing slash (/). In development visit http://localhost:3000/your-app/.

Running in preview production mode

This command will start webpack dev server, but with NODE_ENV set to production. Everything will be minified and served. Hot reload will not work, so you need to refresh the page manually after changing the code.

npm run preview

Linting

For linting I'm using eslint-config-airbnb, but some options are overridden to my personal preferences.

$ npm run lint

Git hooks

Linting pre-push hook is not enabled by default. It will prevent the push if lint task fails, but you need to add it manually by running:

npm run hook-add

To remove it, run this task:

npm run hook-remove

---

Changelog

0.0.3

• Added pre-push git hook
• Added preview task

0.0.2

• Added Redux Dev Tools.
• Renamed client to source
• Made sure logger and DevTools are loaded only in development

0.0.1

Initial release