{"body":"","commit":{"authorName":"Dan Abramov","authorEmail":"dan.abramov@gmail.com","revision":"db140c887f389995b8be2ddbfb33601b49708c12","shortRevision":"db140c887f","authoredAt":"2016-11-17T15:55:56+00:00","subject":"Explain Installation in more detail"},"patch":"diff --git a\/docs\/docs\/installation.md b\/docs\/docs\/installation.md\nindex ea3e5faa96..094a1c5e3d 100644\n--- a\/docs\/docs\/installation.md\n+++ b\/docs\/docs\/installation.md\n@@ -31,19 +31,49 @@ cd hello-world\n npm start\n ```\n \n-Create React App doesn't handle backend logic or databases; it just creates a frontend build pipeline, so you can use it with any backend you want. It uses Webpack, Babel and ESLint under the hood, but configures them for you.\n+Create React App doesn't handle backend logic or databases; it just creates a frontend build pipeline, so you can use it with any backend you want. It uses [webpack](https:\/\/webpack.js.org\/), [Babel](http:\/\/babeljs.io\/) and [ESLint](http:\/\/eslint.org\/) under the hood, but configures them for you.\n \n ## Adding React to an Existing Application\n \n-### Using npm\n+You don't need to rewrite your app to start using React.\n \n-We recommend using React from npm with a bundler like [Browserify](http:\/\/browserify.org\/) or [webpack](https:\/\/webpack.github.io\/). If you use npm for client package management, you can install React with:\n+We recommend adding React to a small part of your application, such an individual widget, so you can see if it works well for your use case.\n+\n+While React [can be used](\/react\/docs\/react-without-es6.html) without a build pipeline, we recommend setting it up so you can be more productive. A modern build pipeline typically consists of:\n+\n+* A **package manager**, such as [Yarn](https:\/\/yarnpkg.com\/) or [npm](https:\/\/www.npmjs.com\/). It lets you take advantage of a vast ecosystem of third-party packages, and easily install or update them.\n+* A **bundler**, such as [webpack](https:\/\/webpack.github.io\/) or [Browserify](http:\/\/browserify.org\/). It lets you write modular code and bundle it together into small packages to optimize load time.\n+* A **compiler** such as [Babel](http:\/\/babeljs.io\/). It lets you write modern JavaScript code that still works in older browsers.\n+\n+### Installing React\n+\n+We recommend using [Yarn](https:\/\/yarnpkg.com\/) or [npm](https:\/\/www.npmjs.com\/) for managing front-end dependencies. If you're new to package managers, [Yarn documentation](https:\/\/yarnpkg.com\/en\/docs\/getting-started) is a good place to get started.\n+\n+To install React with Yarn, run:\n+\n+```bash\n+yarn add react react-dom\n+```\n+\n+To install React with npm, run:\n \n ```bash\n npm install --save react react-dom\n ```\n \n-and import it from your code with something like:\n+Both yarn and npm work with the npm registry.\n+\n+### Enabling ES6 and JSX\n+\n+We recommend using React with [Babel](http:\/\/babeljs.io\/) to let you use ES6 and JSX in your JavaScript code. ES6 is a set of modern JavaScript features that make development easier, and JSX is an extension to the JavaScript language that works nicely with React.\n+\n+The [Babel setup instructions](https:\/\/babeljs.io\/docs\/setup\/) explain how to configure Babel in many different build environments. Make sure you install [`babel-preset-react`](http:\/\/babeljs.io\/docs\/plugins\/preset-react\/#basic-setup-with-the-cli-) and [`babel-preset-es2015`](http:\/\/babeljs.io\/docs\/plugins\/preset-es2015\/#basic-setup-with-the-cli-) and enable them in your [`.babelrc` configuration](http:\/\/babeljs.io\/docs\/usage\/babelrc\/), and you're good to go.\n+\n+### Hello World with ES6 and JSX\n+\n+We recommend using a bundler like [webpack](https:\/\/webpack.github.io\/) or [Browserify](http:\/\/browserify.org\/) so you can write modular code and bundle it together into small packages to optimize load time.\n+\n+The smallest React example looks like this:\n \n ```js\n import React from 'react';\n@@ -55,28 +85,42 @@ ReactDOM.render(\n );\n ```\n \n-This code renders into an HTML element with the id of `root` so you need `

<\/div>` somewhere in your HTML file. When you use React in this way, you should be transpiling your JavaScript using Babel with the `es2015` and `react` presets. To use React in production mode, set the environment variable `NODE_ENV` to `\"production\"`.\n+This code renders into a DOM element with the id of `root` so you need `

<\/div>` somewhere in your HTML file.\n \n-If you use Bower, React is available via the `react` package.\n+Similarly, you can render a React component inside a DOM element somewhere inside your existing app written with any other JavaScript UI library.\n \n-### Enabling ES6 and JSX\n+### Development and Production Versions\n+\n+By default, React includes many helpful warnings. These warnings are very useful in development. However, they make React larger and slower so you should make sure to use the production version when you deploy the app.\n+\n+#### Create React App\n+\n+If you use [Create React App](https:\/\/github.com\/facebookincubator\/create-react-app), `npm run build` will create an optimized build of your app in the `build` folder.\n+\n+#### Webpack\n+\n+Include both `DefinePlugin` and `UglifyJsPlugin` into your production Webpack configuration as described in [this guide](https:\/\/webpack.js.org\/guides\/production-build\/).\n \n-We recommend using React with Babel to let you use ES6 and JSX in your JavaScript code. ES6 is a set of modern JavaScript features that make development easier, and JSX is an extension to the JavaScript language that works nicely with React. The [Babel setup instructions](https:\/\/babeljs.io\/docs\/setup\/) explain how to configure Babel in many different build environments. Make sure you install `babel-preset-react` and `babel-preset-es2015` and enable them in your `.babelrc`, and you're good to go.\n+#### Browserify\n+\n+Run Browserify with `NODE_ENV` environment variable set to `production` and use [UglifyJS](https:\/\/github.com\/mishoo\/UglifyJS) as the last build step so that development-only code gets stripped out.\n \n ### Using a CDN\n \n-If you don't want to use npm to manage client packages, the `react` and `react-dom` npm packages also provide UMD distributions in `dist` folders, which are hosted on a CDN:\n+If you don't want to use npm to manage client packages, the `react` and `react-dom` npm packages also provide single-file distributions in `dist` folders, which are hosted on a CDN:\n \n ```html\n

dillon1000/react

Files changed