Skip to content

Commit 28d845c

Browse files
jetpackponyrandycoulman
authored andcommitted
Add causes of dev server not detecting changes (facebook#1422)
* Add causes of dev server not detecting changes Add causes of `npm start` not detecting changes to Troubleshooting chapter of User Guide * Reworded slightly * Update README.md
1 parent c70bdf0 commit 28d845c

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

packages/react-scripts/template/README.md

+14
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,7 @@ You can find the most recent version of this guide [here](https://github.com/fac
6262
- [S3 and CloudFront](#s3-and-cloudfront)
6363
- [Surge](#surge)
6464
- [Troubleshooting](#troubleshooting)
65+
- [`npm start` doesn’t detect changes](#npm-start-doesnt-detect-changes)
6566
- [`npm test` hangs on macOS Sierra](#npm-test-hangs-on-macos-sierra)
6667
- [`npm run build` silently fails](#npm-run-build-silently-fails)
6768
- [`npm run build` fails on Heroku](#npm-run-build-fails-on-heroku)
@@ -1253,6 +1254,19 @@ Note that in order to support routers that use HTML5 `pushState` API, you may wa
12531254
12541255
## Troubleshooting
12551256
1257+
### `npm start` doesn’t detect changes
1258+
1259+
When you save a file while `npm start` is running, the browser should refresh with the updated code.<br>
1260+
If this doesn’t happen, try one of the following workarounds:
1261+
1262+
* If your project is in a Dropbox folder, try moving it out.
1263+
* If the watcher doesn’t see a file called `index.js` and you’re referencing it by the folder name, you [need to restart the watcher](https://github.com/facebookincubator/create-react-app/issues/1164) due to a Webpack bug.
1264+
* Some editors like Vim and IntelliJ have a “safe write” feature that currently breaks the watcher. You will need to disable it. Follow the instructions in [“Working with editors supporting safe write”](https://webpack.github.io/docs/webpack-dev-server.html#working-with-editors-ides-supporting-safe-write).
1265+
* If your project path contains parentheses, try moving the project to a path without them. This is caused by a [Webpack watcher bug](https://github.com/webpack/watchpack/issues/42).
1266+
* On Linux and OS X, you might need to [tweak system settings](https://webpack.github.io/docs/troubleshooting.html#not-enough-watchers) to allow more watchers.
1267+
1268+
If none of these solutions help please leave a comment [in this thread](https://github.com/facebookincubator/create-react-app/issues/659).
1269+
12561270
### `npm test` hangs on macOS Sierra
12571271
12581272
If you run `npm test` and the console gets stuck after printing `react-scripts test --env=jsdom` to the console there might be a problem with your [Watchman](https://facebook.github.io/watchman/) installation as described in [facebookincubator/create-react-app#713](https://github.com/facebookincubator/create-react-app/issues/713).

0 commit comments

Comments
 (0)