Generator-react-reflux NPM

Reactjs Reflux generator

A Yeoman Generator for facebook's React framework and flux architecture using reflux.

What's inside?

gulp
grunt
bower
browserify
reactify
coffeescript
compass
jest
reactjs
reflux
react-router
preprocessify (for environments management)

Usage

Install Yeoman:

npm install -g yo

Install generator-react-reflux:

npm install -g generator-react-reflux

Make a new directory, and cd into it:

mkdir my-new-project && cd $_

Run yo react-reflux, optionally passing an app name:

yo react-reflux [app-name]

If selected install compass

gem install compass

If you chose gulp then run gulp for building and gulp serve for preview. However if you chose grunt then run grunt for building and grunt server for preview.

Generators

Available generators:

Note: Generators are to be run from the root directory of your app.

App

Sets up a new ReactJS app using the flux architecture implemented by reflux, generating all the boilerplate you need to get started.

Example:

yo react-reflux

Options:

--modernizr
```
	Include Modernizr.
```
--coffee-script
```
	Generate scripts in CoffeeScript.
```
--compass
```
	Generate stylesheets in Compass.
```

--jest

	Generate testing boilerplate with Jest.

--bootstrap
```
	Include React Bootstrap.
```
--build-tool=[grunt|gulp]
Generate build config in the selected tool. Defaults to gulp.
--skip-install
Skips the automatic execution of bower and npm after scaffolding has finished.

Component

Generates a ReactJS component in app/scripts/components.

Example:

yo react-reflux:component dashboard

Options:

--coffee-script
Generate the component in CoffeeScript.

Store

Generates a RefluxJS store in app/scripts/stores.

Example:

yo react-reflux:store user

Options:

--coffee-script
Generate the store in CoffeeScript.

Actions

Generates RefluxJS actions in app/scripts/actions.

Example:

yo react-reflux:actions user

Options:

--coffee-script
Generate the actions in CoffeeScript.

Testing

Running npm test will run the unit tests with mocha.

Changelog

Recent changes can be viewed on Github on the Releases Page

Contribute

See the contributing docs

When submitting an issue, please follow the guidelines. Especially important is to make sure Yeoman is up-to-date, and providing the command or commands that cause the issue.

When submitting a bugfix, write a test that exposes the bug and fails before applying your fix. Submit the test alongside the fix.

When submitting a new feature, add tests that cover the feature.