React & Redux Generator

A Yeoman generator for React & Redux for projects vertically integrated.

Of those out there, the React and Redux templates have a horizontal structure for their projects. This means all of your elements belong in the same folder, i.e. your components go in a components folder.

This generator works for vertically integrated React and Redux projects. The sub-generator will create modules for you with a smaller version of the horizontal structure. Each module is self-contained, although there may be a base that is common to everything else.

This repo is copied from React/Flux Vertical generator, which I'm de-comissioning in favor of this one.

Installation

Yeoman

For this generator to work, Yeoman must be globally installed.

npm install -g yo

Then you can install this generator-react-redux-modules module. I do not maintain generator-react-redux.

npm install -g generator-react-redux-modules

Base Generator

Creates the base project. Loosely based off React-starter-kit.

yo react-redux-modules

This will compile base files, including the Source, and Tools folders. (tests pending)

Options

| Option | Description | Default | | ------ | ----------- | ------- | | -h, --help | Print the generator's options and usage | | | --skip-cache | Do not remember prompt answers | Default: false | | --skip-install | Do not automatically install dependencies | Default: false |

Sub-generators

The sub generators assumes you already have a project up and running. They are to help you through developing new modules, components, etc.

Module

When you need to start creating new modules, simple use the sub-generator module.

yo react-redux-modules:module [options] <moduleName>

Within the module sub-generator, the following default files are generated for you. Replace with your own module name.

Options

| Option | Description | Default | | ------ | ----------- | ------- | | -h, --help | Print the generator's options and usage | | | --skip-cache | Do not remember prompt answers | Default: false | | --skip-install | Do not automatically install dependencies | Default: false |

Arguments

| Arguments | Description | Type | Required | | ----------- | ----------- | ---- | -------- | | moduleName | Name of the module | String | true |

Examples

The following command will generate the following:

yo react-redux-modules:module auth
# Generates the auth folder with all necessary files

Component

If you want to create a component other modules depend on, this sub-generator will create the files needed for you.

Within the component sub-generator, the following default files are generated for you. Replace #{CommonComponentName} with your own module name.

.
└── src
    └── common
        └── components
             └── CommonComponentName
                 ├── CommonComponentName.js
                 ├── CommonComponentName.scss
                 └── package.json

Arguments

| Arguments | Description | Type | Required | | -------------- | ------------------ | ------ | -------- | | componentName | Name of the module | String | true | | componentRoot | Name of the module | String | true |

Options

| Option | Description | Default | | ------ | ----------- | ------- | | -h, --help | Print the generator's options and usage | | | --skip-cache | Do not remember prompt answers | Default: false | | --skip-install | Do not automatically install dependencies | Default: false | | --raw | Use user input raw format for component name | Default: false |

Examples

The following command will generate the following:

yo react-redux-modules:component TextBox ./src/common/components --raw
# Generates the following:
.
└── src
    └── common
        └── components
             └── TextBox
                 ├── TextBox.js
                 ├── TextBox.scss
                 └── package.json

Action Test

If you want to generate an action test, for a known module, this sub-generator will help.

Within the component sub-generator, the following default files are generated for you.

Replace #{module} and #{action} with your own module and action names.

.
└── test
    └── unit
        └── module
             └── actions
                 └── action.spec.js

Arguments

| Arguments | Description | Type | Required | | -------------- | ------------------ | ------ | -------- | | module | Name of the module | String | true | | action | Name of the action | String | true |

Examples

The following command will generate the following:

yo react-redux-modules:actionTests Analytics Partners

# Generates the following:
.
└── test
    └── unit
        └── Analytics
            └── actions
                └── Partners.spec.js

Contributing

Anyone and everyone is welcome to contribute, however, if you decide to get involved, please take a moment to review the guidelines:

• Bug reports
• Feature requests
• Pull requests

License

The code is available under the MIT license.