Skip to content

Commit f34c72e

Browse files
authored
Add updating instructions
Fixes facebook#119
1 parent 8cef20d commit f34c72e

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

template/README.md

+18
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ You can find the most recent version of this guide [here](https://github.com/fac
33

44
## Table of Contents
55

6+
- [Updating to New Releases](#updating-to-new-releases)
67
- [Sending Feedback](#sending-feedback)
78
- [Folder Structure](#folder-structure)
89
- [Available Scripts](#available-scripts)
@@ -22,6 +23,23 @@ You can find the most recent version of this guide [here](https://github.com/fac
2223
- [Deploying](#deploying)
2324
- [Something Missing?](#something-missing)
2425

26+
## Updating to New Releases
27+
28+
Create React App is divided into two packages:
29+
30+
* `create-react-app` is a global command-line utility that you use to create new projects.
31+
* `react-scripts` is a development dependency in the generated projects (including this one).
32+
33+
You almost never need to update `create-react-app` itself: it’s delegates all the setup to `react-scripts`.
34+
35+
When you run `create-react-app`, it always creates the project with the latest version of `react-scripts` so you’ll get all the new features and improvements in newly created apps automatically.
36+
37+
To update an existing project to a new version of `react-scripts`, [open the changelog](https://github.com/facebookincubator/create-react-app/blob/master/CHANGELOG.md), find the version you’re currently on (check `package.json` in this folder if you’re not sure), and apply the migration instructions for the newer versions.
38+
39+
In most cases bumping the `react-scripts` version in `package.json` and running `npm install` in this folder should be enough, but it’s good to consult the [changelog](https://github.com/facebookincubator/create-react-app/blob/master/CHANGELOG.md) for potential breaking changes.
40+
41+
We commit to keeping the breaking changes minimal so you can upgrade `react-scripts` painlessly.
42+
2543
## Sending Feedback
2644

2745
We are always open to [your feedback](https://github.com/facebookincubator/create-react-app/issues).

0 commit comments

Comments
 (0)