There seems to still be confusion regarding the plan for CRA (for example: https://github.com/facebook/create-react-app/issues/13072), as CRA's readme and docs don't mention the plan Dan Abramov has recently discussed on Twitter, GitHub, and Reddit:
Additionally, many beginners are trying to find best practices on search engines, and since "create a react app" looks very similar to "create react app", search engines are still listing these docs on the first page of results (some still have it as the first result).
Describe the solution you'd like
I'd suggest a simple banner in the docs, similar to the previous BLM and current Ukraine banners, making it clear that CRA isn't currently recommended now and linking to the team's plan, for example:
This may not be seen by all users, especially if they're using an older third party resource. If the create-react-app or react-scripts packages are not going to be used in the plan for CRA, I'd recommend deprecating them. Otherwise, it would probably be a good idea to add a similar message to the logs of the CLI
Additionally, it may help to add migration guides. Vite is the most straightforward replacement for CRA currently. If a similar tooling setup to CRA is desired, I also have an open source Vite + React + Testing template.
Is your proposal related to a problem?
There seems to still be confusion regarding the plan for CRA (for example: https://github.com/facebook/create-react-app/issues/13072), as CRA's readme and docs don't mention the plan Dan Abramov has recently discussed on Twitter, GitHub, and Reddit:
Additionally, many beginners are trying to find best practices on search engines, and since "create a react app" looks very similar to "create react app", search engines are still listing these docs on the first page of results (some still have it as the first result).
Describe the solution you'd like
I'd suggest a simple banner in the docs, similar to the previous BLM and current Ukraine banners, making it clear that CRA isn't currently recommended now and linking to the team's plan, for example:
Describe alternatives you've considered
This may not be seen by all users, especially if they're using an older third party resource. If the
create-react-app
orreact-scripts
packages are not going to be used in the plan for CRA, I'd recommend deprecating them. Otherwise, it would probably be a good idea to add a similar message to the logs of the CLIAdditionally, it may help to add migration guides. Vite is the most straightforward replacement for CRA currently. If a similar tooling setup to CRA is desired, I also have an open source Vite + React + Testing template.