Misleading statement: "You almost never need to update create-react-app itself"

Is this a bug report?

No, it’s about the documentation.

Which terms did you search for in User Guide?

misleading documentation update

---

A few weeks I started a new project with the new version of create-react-app --typescript. In the process I intended to update create-react-app. I searched about it and arrived at this page (Create-React-App documenation), where I read:

You almost never need to update create-react-app itself: it delegates all the setup to react-scripts.

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.

I figured out updating CRA is not necessary. As a result the new project of create-react-app was not created properly (see here). Files were not created with .tsx extension, typescript and type libraries were not installed etc.

I also had another related bug - running npx create-react-app --info produced an error. Yesterday I updated Create-React-App itself and that solved the bugs. I had a relatively updated version of create react app as I reinstalled everything on this computer 4 months ago.

Can you please remove the statements above, or update them?

[carpben]

I just visitied https://facebook.github.io/create-react-app/docs/getting-started. Installtion instructions have changed; I think in the past users were recommended to run something like `npm i -g create-react-app". So I guess this is the source of the problem.

[ianschmitz]

I’ve created #6157 to hopefully clear this up. It’s come up a number of times recently after the addition of the --typescript option to the CLI. For users that have an older version installed globally, npx will use that cached version.