kobbiman / react-boilerplate

A slightly opinionated setup for ReactJS

react-boilerplate

A slightly opinionated setup for ReactJS projects

http://mikechabot.github.io/react-boilerplate/

Features

Build Process

• Built with webpack
• Supports ES6 via Babel transpiling

State Management

• redux for state management
• react-redux for stateful component bindings
• redux-thunk for asynchronous actions
• redux-logger for capturing actions

Routing

• react-router for client-side routing

HTTP

• Customizable, promise-based HTTP support via Axios
• Implementing data services utilize Promise

Styling

• Supports SCSS & SASS syntax
• Browser compatibility via autoprefixing

Develop & Deploy

• Environmental configurations for both webpack and redux
  • Dev // webpack-dev-server with React Hot Loader for live refresh. redux-logger enabled.
  • Prod // Express server with redux-logger disabled.
• See here and here

Testing

• Tested with Mocha
• Coverage support via Istanbul
• react-addons-test-utils for component testing
• redux-mock-store for Redux state testing
• Sinon.JS for mocking, stubbing & spying

Get Started

1. git clone https://github.com/mikechabot/react-boilerplate.git
2. npm install
3. Launch environment:

• Production: npm start
• Development: npm run dev

Test Commands

• npm test: Shortcut for test:coverage
• npm run test:unit: Run unit tests located in test/unit/**/*.js
• npm run test:integration: Run integration tests location in test/integration/**/*.js
• npm run test:coverage: Run coverage for unit and integration tests