react-app-tools-telesoho
Version:
Boilerplate and tooling for JavaScript application development with React
121 lines (80 loc) • 5.88 kB
Markdown
# React App SDK <a href="https://github.com/kriasoft/react-app/stargazers"><img src="https://img.shields.io/github/stars/kriasoft/react-app.svg?style=social&label=Star&maxAge=3600" height="20"></a> <a href="https://twitter.com/ReactSDK"><img src="https://img.shields.io/twitter/follow/ReactSDK.svg?style=social&label=Follow&maxAge=3600" height="20"></a>
**CLI tool and templates** for authoring **[React](https://facebook.github.io/react/)** applications with a single dev dependency and zero build/run configuration.
### TL;DR
```sh
$ npm install -g react-app
$ react-app new
$ react-app run
```
**See** [demo](https://rsb.kriasoft.com), [docs](https://github.com/kriasoft/react-static-boilerplate/tree/master/docs)
| **Join** [#react-app](https://gitter.im/kriasoft/react-app) chat on Gitter to stay up to date
| **Follow us** on [Twitter](https://twitter.com/ReactSDK)
| **Learn** [React.js and ES6](#learn-reactjs-and-es6)
<img src="https://koistya.github.io/files/react-app-starter-kit.png" width="100%">
### Features
✓ Zero-configuration, no build scripts, just one development dependency (see [`package.json`](templates/app/package.json))<br>
✓ Modern JavaScript syntax ([ES2015](http://babeljs.io/docs/learn-es2015/)+) via [Babel](http://babeljs.io/) or [TypeScript](https://www.typescriptlang.org/) (planned), modern CSS syntax via [PostCSS](https://github.com/postcss/postcss)<br>
✓ Component-based UI architecture via [React](http://facebook.github.io/react/), [Webpack](https://webpack.github.io/) and [CSS Modules](https://github.com/css-modules/css-modules)<br>
✓ Application state management /w time-travel debugging via [Redux](http://redux.js.org/) (see [`main.js`](templates/app/main.js), [`core/store.js`](templates/app/core/store.js))<br>
✓ Routing and navigation via [`path-to-regexp`](https://github.com/pillarjs/path-to-regexp) and [`history`](https://github.com/mjackson/history) (see [`main.js`](templates/app/main.js), [`core/router.js`](templates/app/core/router.js), [`utils/routes-loader.js`](templates/app/utils/routes-loader.js))<br>
✓ [Code-splitting](https://github.com/webpack/docs/wiki/code-splitting) and async chunk loading via [Webpack](https://webpack.github.io/) and [ES6 System.import()](http://www.2ality.com/2014/09/es6-modules-final.html)<br>
✓ Cross-device testing with [Browsersync](https://browsersync.io/) /w Hot Module Replacement ([HMR](https://webpack.github.io/docs/hot-module-replacement.html)) and [React Hot Loader](http://gaearon.github.io/react-hot-loader/)<br>
✓ **24/7** community support on [Gitter](https://gitter.im/kriasoft/react-app) and [SO](http://stackoverflow.com/questions/tagged/react-app); consulting and customization requests on [Codementor](https://www.codementor.io/koistya) or [Skype](http://hatscripts.com/addskype?koistya)<br>
### Requirements
* MAC OS X, Windows, or Linux
* [Node.js](https://nodejs.org) v6 or newer
### Getting Started
Install [`react-app`](https://www.npmjs.com/package/react-app) npm package globally.
```sh
$ npm install -g react-app
```
Scaffold a new JavaScript application project and launch it by running:
```sh
$ react-app new
$ react-app run
```
The app should become available at [http://localhost:3000](http://localhost:3000)
For more information visit [`/templates/app`](https://github.com/kriasoft/react-app/tree/master/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](https://github.com/kriasoft/react-app/fork), customize it and use it
instead of of the original `react-app-tools` npm module. For example (`package.json`):
```js
{
"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",
}
}
```
### Learn React.js and ES6
:mortar_board: **[React.js Training Program](http://www.reactjsprogram.com/?asdf=36750_q0pu0tfa)** by Tyler McGinnis<br>
:mortar_board: **[React for Beginners](https://reactforbeginners.com/friend/konstantin)** and **[ES6 Training Course](https://es6.io/friend/konstantin)** by Wes Bos<br>
:green_book: **[React: Up & Running: Building Web Applications](http://amzn.to/2bvwOOV)** by Stoyan Stefanov (Aug, 2016)<br>
:green_book: **[Getting Started with React](http://amzn.to/2bzsTxM)** by Doel Sengupta and Manu Singhal (Apr, 2016)<br>
:green_book: **[You Don't Know JS: ES6 & Beyond](http://amzn.to/2bBhL87)** by Kyle Simpson (Dec, 2015)<br>
### Contribute
Help shape the future of **React App SDK** by joining our [community](https://gitter.im/kriasoft/react-app)
today, check out the [open issues](https://github.com/kriasoft/react-app/issues), submit [new
feature ideas](https://github.com/kriasoft/react-app/issues/new?labels=enhancement) and [bug
reports](https://github.com/kriasoft/react-app/issues/new?labels=bug), send us [pull
requests](CONTRIBUTING.md#pull-requests)!
### Support
* [#react-app](http://stackoverflow.com/questions/tagged/react-app) on Stack Overflow
* [#react-app](https://gitter.im/kriasoft/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](https://github.com/kriasoft/react-app/blob/master/LICENSE.txt) file.
---
Made with ♥ by Konstantin Tarkus ([@koistya](https://twitter.com/koistya)) and [contributors](https://github.com/kriasoft/react-app/graphs/contributors)