react-app

React App SDK  

CLI tools and templates for authoring React applications with a single dev dependency and zero build/run configuration.

TL;DR

$ npm install -g react-app
$ react-app new
$ react-app run

See demo, docs  |  Join #react-app chat on Gitter to stay up to date  |  Follow us on Twitter  |  Send feedback to @koistya

Features

    ✓ Zero-configuration, no build scripts, just one development dependency (see package.json)
    ✓ Modern JavaScript syntax (ES2015+) via Babel or TypeScript (planned), modern CSS syntax via PostCSS
    ✓ Component-based UI architecture via React, Webpack and CSS Modules
    ✓ Application state management /w time-travel debugging via Redux (see main.js, core/store.js)
    ✓ Routing and navigation via path-to-regexp and history (see main.js, core/router.js, utils/routes-loader.js)
    ✓ Code-splitting and async chunk loading via Webpack and ES6 System.import()
    ✓ Cross-device testing with Browsersync /w Hot Module Replacement (HMR) and React Hot Loader
    ✓ 24/7 community support on Gitter and SO; consulting and customization requests on Codementor or Skype

Requirements

• MAC OS X, Windows, or Linux
• Node.js v6 or newer

Getting Started

Install react-app npm package globally.

$ npm install -g react-app

Scaffold a new JavaScript application project and launch it by running:

$ react-app new
$ react-app run

The app should become available at http://localhost:3000

For more information visit /templates/app

How to Customize

Coming soon...

Escape Hatch

If you’re a power user and you aren’t happy with the default configuration, you can always fork react-app repository, customize it and use it instead of of the original react-app-tools npm module. For example (package.json):

{
  "private": true,
  "dependencies": {
    "react": "^15.2.1",
    "react-app": "^1.1.1",
    "react-dom": "^15.2.1"
  },
  "devDependencies": {
    "react-app-tools": "git+https://github.com/<username>/react-app.git",
  },
  "scripts": {
    "build": "react-app build",
    "start": "react-app run",
  }
}

Contribute

Help shape the future of React App SDK by joining our community today, check out the open issues, submit new feature ideas and bug reports, send us pull requests!

Support

• #react-app on Stack Overflow
• #react-app chat room on Gitter

License

Copyright © 2016-present Kriasoft, LLC. This source code is licensed under the MIT license found in the LICENSE.txt file.

Made with ♥ by Konstantin Tarkus (@koistya) and contributors