/ignite

The unfair starting CLI, Generator, and more for React Native

Primary LanguageJavaScriptMIT LicenseMIT

npm version Build Status Coverage Status js-standard-style

Ignite

Ignite 2 screenshot

🔥 The hottest CLI for React Native, boilerplates, plugins, generators, and more. 🔥

Ignite 2 is here!

After months of work and sweat and tears, Ignite 2 (beta) has landed! We're incredibly proud of where Ignite 2 is and where it's headed.

Cliff notes version of the difference between Ignite 1 and 2:

Ignite 1 was a (very nice!) React Native boilerplate. Ignite 2 is a CLI and generator for React Native with boilerplates, plugins, and more. Where before you had one choice -- Infinite Red's boilerplate -- now you can choose from many boilerplates and also add standalone plugins as you need them. It's much more modular and extensible than Ignite 1.

If you really liked Ignite 1 as it was, then not much has changed! You just run ignite new MyApp --max and everything feels pretty normal from there.

Quick Example

$ npm install -g ignite-cli
$ ignite new PizzaApp
$ cd PizzaApp
$ ignite add maps
$ ignite add vector-icons
$ ignite generate screen PizzaLocationList
$ ignite generate component PizzaLocation
$ ignite generate map StoreLocator
$ ignite add i18n
$ ignite remove i18n
$ ignite i love you

Why Ignite?

  • Easily spin up a new React Native app with best practices built-in
  • No runtime! This is a developer tool only, not a library you have to depend on
  • An ever-expanding list of boilerplates and plugins
  • Powerful but well-defined behavior
  • Battle tested and used every day by the developers at Infinite Red

And you also get (by default) all of the sweet, sweet goodness of our default boilerplate:

  • Works with iOS and Android out of the box
  • Useful generators, including components, screens, styles, and more
  • API-ready -- hook it up and start talking to your server
  • Standard-js compliant code
  • Redux and redux-sagas state management
  • Well-documented code
  • Gorgeous Ava tests
  • and much, much more... go check out the readme (WIP during alpha)

⬇️ Install

First, make sure you're set up for React Native

then...

Make sure you have Node 7.6+

While you are free to use whichever node version manager you like, we like using n

If you currently use nvm and would like to switch, follow these steps

You can check your version of node by running

node -v

then install Yarn for your system

finally...

All global installs below are using npm over yarn because of this bug on Windows.

$ npm install -g ignite-cli
$ ignite new MyNewAppName

📋 Documentation 📋

Want to dive into the Ignite 2 documentation? Go here Looking for React Native's documentation? Go here

🔌 Plugins 🔌

Check out the list of Plugins

🍽️ Boilerplates 🍽️

Check out the list of Boilerplates

💩 Troubleshooting 💩

If you run into problems, first search the issues in this repository. If you don't find anything, you can either file an issue or come talk to our friendly developers in the Infinite Red Community Slack (community.infinite.red).

🔭 Where to Go From Here 🔭

Contribute to Ignite - Getting up and running for your first pull request

Chat with us on the IR Community - Infinite Red devs standing by

Who are We? - Learn More About Infinite Red

Project Web Page - Ignite on Infinite Red

❤️ Special Thanks ❤️

Thank you to the numerous contributors of Ignite. Our awe and appreciation for the friendliness of Open Source is the fuel for all Infinite Red projects like Ignite.

Premium Support

Ignite, as open source projects, is free to use and always will be. Infinite Red offers premium Ignite support and general mobile app design/development services. Email us at hello@infinite.red to get in touch with us for more details.