banderson / generator-redux

CLI tools for Redux: next-gen functional Flux/React with devtools
252 stars 36 forks source link

Obsolete: use Create React App / Redux starter kit

Redux and Redux-devtools CLI

CLI for Redux: next-gen functional Flux/React with devtools. This is intended to be the successor to my existing generator-flux that was based on vanilla FB flux.

Getting Started

What is Redux?

It's "Atomic Flux with hot reloading", a next-generation take on the Flux pattern with a few core philosophical design differences, including:

  • Preserves the benefits of Flux, but adds other nice properties thanks to its functional nature.
  • Prevents some of the anti-patterns common in Flux code.
  • Works great in universal (aka "isomorphic") apps because it doesn't use singletons and the data can be rehydrated. ...

Features included in this Generator:

Coming soon:

Prerequisites

You must have Node.js w/NPM installed. I recommend installing via homebrew, but you should be able to use the pre-built installers if you prefer.

Also, generator-redux is a Yeoman generator. If you do not have Yeoman installed, first run:

$ npm install -g yo

Installing the generator

To install generator-redux from npm, run:

$ npm install -g generator-redux

Finally, initiate the generator:

$ yo redux

Configuration Options

During install-time, you will be prompted to enter some information to help create the project structure and package.json file:

Running your scaffolded project

The generated project includes a hot-reloading static server. To start the server, run:

$ npm start

To run the server with the dev-tools enabled, run:

$ DEBUG=true npm start

To build for production, run:

$ npm run build

License

MIT