{"parents":["3fd582643ef3d222a00a0c756292c15b88f9f83c"],"patch":"diff --git a\/docs\/_posts\/2016-07-22-create-apps-with-no-configuration.md b\/docs\/_posts\/2016-07-22-create-apps-with-no-configuration.md\nnew file mode 100644\nindex 0000000000..246556f9ce\n--- \/dev\/null\n+++ b\/docs\/_posts\/2016-07-22-create-apps-with-no-configuration.md\n@@ -0,0 +1,165 @@\n+---\n+title: \"Create Apps with No Configuration\"\n+author: gaearon\n+---\n+\n+**[Create React App](https:\/\/github.com\/facebookincubator\/create-react-app)** is a new officially supported way to create single-page React applications. It offers a modern build setup with no configuration.\n+\n+## Getting Started\n+\n+### Installation\n+\n+First, install the global package:\n+\n+```sh\n+npm install -g create-react-app\n+```\n+\n+Node.js 4.x or higher is required.\n+\n+### Creating an App\n+\n+Now you can use it to create a new app:\n+\n+```sh\n+create-react-app hello-world\n+```\n+\n+This will take a while as npm installs the transient dependencies, but once it’s done, you will see the list the commands you can run in the created folder:\n+\n+![created folder](http:\/\/i.imgur.com\/2suYgKq.png)\n+\n+### Starting the Server\n+\n+Run `npm start` to launch the development server. The browser will open automatically with the created app’s URL.\n+\n+![compiled successfully](http:\/\/i.imgur.com\/amyNfCN.png)\n+\n+Create React App uses both Webpack and Babel under the hood. \n+The console output is tuned to be minimal to help you focus on the problems:\n+\n+![failed to compile](http:\/\/i.imgur.com\/FnLVfw6.png)\n+\n+ESLint is also integrated so lint warnings are displayed right in the console:\n+\n+![compiled with warnings](http:\/\/i.imgur.com\/Ay2TNeB.png)\n+\n+We only picked a small subset of lint rules that often lead to bugs.\n+\n+### Building for Production\n+\n+To build an optimized bundle, run `npm run build`:\n+\n+![npm run build](http:\/\/i.imgur.com\/MMCjzE9.png)\n+\n+It is minified, correctly envified, and the assets include content hashes for caching.\n+\n+### One Dependency\n+\n+Your `package.json` contains only a single build dependency and a few scripts:\n+\n+```js\n+{\n+ \"name\": \"hello-world\",\n+ \"dependencies\": {\n+ \"react\": \"^15.2.1\",\n+ \"react-dom\": \"^15.2.1\"\n+ },\n+ \"devDependencies\": {\n+ \"react-scripts\": \"0.1.0\"\n+ },\n+ \"scripts\": {\n+ \"start\": \"react-scripts start\",\n+ \"build\": \"react-scripts build\",\n+ \"eject\": \"react-scripts eject\"\n+ }\n+}\n+```\n+\n+We take care of updating Babel, ESLint, and Webpack to stable compatible versions so you can update a single dependency to get them all.\n+\n+### Zero Configuration\n+\n+It is worth repeating: there is no configuration files or complicated folder structures. The tool only generates the files you need to build your app.\n+\n+```\n+hello-world\/\n+ README.md\n+ index.html\n+ favicon.ico\n+ node_modules\/\n+ package.json\n+ src\/\n+ App.css\n+ App.js\n+ index.css\n+ index.js\n+ logo.svg\n+```\n+\n+All the build settings are preconfigured and can’t be changed. Some features, such as testing, are currently missing. This is an intentional limitation, and we recognize it might not work for everybody. And this brings us to the last point.\n+\n+### No Lock-In\n+\n+We first saw this feature in [Enclave](https:\/\/github.com\/eanplatter\/enclave), and we loved it. We talked to [Ean](https:\/\/twitter.com\/EanPlatter), and he was excited to collaborate with us. He already sent a few pull requests!\n+\n+“Ejecting” lets you leave the comfort of Create React App setup at any time. You run a single command, and all the build dependencies, configs, and scripts are moved right into your project. At this point you can customize everything you want, but effectively you are forking our configuration and going your own way. If you’re experienced with build tooling and prefer to fine-tune everything to your taste, this lets you use Create React App as a boilerplate generator.\n+\n+We expect that at early stages, many people will “eject” for one reason or another, but as we learn from them, we will make the default setup more and more compelling while still providing no configuration.\n+\n+## Try It Out!\n+\n+You can find [**Create React App**](http:\/\/github.com\/facebookincubator\/create-react-app) with additional instructions on GitHub.\n+\n+This is an experiment, and only time will tell if it becomes a popular way of creating and building React apps, or fades into obscurity.\n+\n+We welcome you to participate in this experiment. Help us build the React tooling that more people can use. We are always [open to feedback](https:\/\/github.com\/facebookincubator\/create-react-app\/issues\/11).\n+\n+## The Backstory\n+\n+React was one of the first libraries to embrace transpiling JavaScript. As a result, even though you can [learn React without any tooling](https:\/\/github.com\/facebook\/react\/blob\/3fd582643ef3d222a00a0c756292c15b88f9f83c\/examples\/basic-jsx\/index.html), the React ecosystem has commonly become associated with an overwhelming explosion of tools.\n+\n+Eric Clemmons called this phenomenon the “[JavaScript Fatigue](https:\/\/medium.com\/@ericclemmons\/javascript-fatigue-48d4011b6fc4)”:\n+\n+>Ultimately, the problem is that by choosing React (and inherently JSX), you’ve unwittingly opted into a confusing nest of build tools, boilerplate, linters, & time-sinks to deal with before you ever get to create anything.\n+\n+It is tempting to write code in ES2015 and JSX. It is sensible to use a bundler to keep the codebase modular, and a linter to catch the common mistakes. It is nice to have a development server with fast rebuilds, and a command to produce optimized bundles for production.\n+\n+Combining these tools requires some experience with each of them. Even so, it is far too easy to get dragged into fighting small incompatibilities, unsatisfied peerDependencies, and illegible configuration files.\n+\n+Many of those tools are plugin platforms and don’t directly acknowledge each other’s existence. They leave it up to the users to wire them together. The tools mature and change independently, and tutorials quickly get out of date.\n+\n+

Marc was almost ready to implement his "hello world" React app pic.twitter.com\/ptdg4yteF1<\/a><\/p>— Thomas Fuchs (@thomasfuchs) March 12, 2016<\/a><\/blockquote>\n+

dillon1000/react

Files changed