param-harrison / generator-rn-toolbox

The React Native Generator to bootstrap your apps

React Native Toolbox

Yeoman generators to kickstart your react-native v0.48+ projects.

As of now, the way those generators are configured is heavily opinionated and based on our own company needs.

Features

In an existing React Native project, our generator contains sub-generators that will help you with:

• Setup
  • Linting -- yo rn-toolbox:lint
  • Base project -- yo rn-toolbox:base
  • Jest -- yo rn-toolbox:jest
  • Fastlane setup for multiple environments -- yo rn-toolbox:fastlane-setup
  • Fastlane environment instantiation -- yo rn-toolbox:fastlane-env
  • Icons and Splashscreen generation -- yo rn-toolbox:assets [--icon | --splash] <path>
• Environment
  • Visual Studio Code -- yo rn-toolbox:vscode
• Continuous integration / deployment
  • TravisCI -- yo rn-toolbox:travisci
  • Bitrise for continuous deployment -- yo rn-toolbox:bitrise

Requirements

• You need node > 6 installed
• Ruby > 2.2.3
• Bundler installed (gem install bundler)
• Yeoman installed (npm i -g yo)
• Yarn installed (brew install yarn)

Usage

Install the main yeoman generator:

npm install -g yo generator-rn-toolbox

Then follow the docs for any sub-generator listed above in the features.

If starting from scratch, use the react-native init <ProjectName> && cd <ProjectName> command to instantiate your React Native Project (for more go see the official React Native getting started).

It is recommended to initiate the git repository right after instantiating the app and to do you first commit.

It is also recommended to do a separate commit after running each of these steps.

Contributing

See our contributing guidelines

Local development

To run the generator with your local version:

git clone https://github.com/bamlab/generator-rn-toolbox.git
cd generator-rn-toolbox
npm link

When you're done, you can run npm unlink to stop using your local version.