React application boilerplate
JavaScript HTML CSS
Latest commit 6907e97 May 16, 2016 @LiraNuna LiraNuna Upgraded dependencies

README.md

React App Boilerplate

Start developing React JS applications easily with the included tooling. Using gulp with browserify and jasmine for testing.

Read more about how it works at: React JS workflow, part 2

Notes

The boilerplate is minimalistic, meaning you have to expand on the current workflow for handling static assets etc.

Install

  • Clone the repo
  • Run npm install

Changes

2.2.3

  • Now works with React 0.13.1 (Thanks to @fatso83)

2.2.2

  • Added es5 shim to testrunner-phantom.js html as phantomJS does not have bind etc.

2.2.1

  • Updated package.json dep versions

2.2.0

  • Using gulp-watch instead of gulp.watch, now reacts to adding and deleting files

2.1.0

  • Fixed watch bug
  • Deploy does not include react-addons

Development

  • Run NODE_ENV=development gulp
  • Go to localhost:8889 to display the app
  • Go to localhost:8889/testrunner.html to see your tests
  • Any changes to app or styles folder will automatically rebuild to build folder
  • Both tests and application changes will refresh automatically in the browser
  • Run gulp test to run all tests with phantomJS and produce XML reports

Minify the code, ready for production

  • Run NODE_ENV=production gulp deploy

Directory

  • build/: Where your automatically builds to. This is where you launch your app in development
  • dist/: Where the deployed code exists, ready for production
  • styles/: Where you put your css files
  • specs/: Where you put your test files
  • gulpfile: Gulp configuration