Skip to content
Switch branches/tags

Essential React

Travis branch Coveralls


A minimal skeleton for building testable React apps using Babel.

Design Goals

  • Use fewer tools (no yeoman, gulp, bower, etc...)
  • Babel 6 with Webpack and Hot Loader
  • Fast testing with mocked-out DOM
  • Import css files as class names
  • Separate Smart and Dumb components
  • No specific implementation of Flux or data fetching patterns

Getting Started

$ npm install

Start the local dev server:

$ npm run server

Navigate to http://localhost:8080/ to view the app.


A core philosophy of this skeleton app is to keep the tooling to a minimum. For this reason, you can find all the commands in the scripts section of package.json.


$ npm run server

Input: src/main.jsx

This leverages React Hot Loader to automatically start a local dev server and refresh file changes on the fly without reloading the page.

It also automatically includes source maps, allowing you to browse code and set breakpoints on the original ES6 code:


$ npm run build

Input: src/main.jsx

Output: build/app.js

Build minified app for production using the production shortcut.


$ npm test

Input: test/main.js

Output: coverage/

Leverages ava to execute the test suite and generate code coverage reports using nyc


$ npm run coveralls

Input: coverage/

Sends the code coverage report generated by nyc to Coveralls.


$ npm run clean

Input: build/app.js

Removes the compiled app file from build.