facebook / create-react-app

Set up a modern web app by running one command.
https://create-react-app.dev
MIT License
102.54k stars 26.79k forks source link

Add banner on plan for CRA to docs #13074

Open nickserv opened 1 year ago

nickserv commented 1 year ago

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:

Our current plan is to make it a launcher for the recommended solutions. See https://github.com/reactjs/reactjs.org/pull/5487#issuecomment-1409720741 for (a lot of) context.

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:

Create React App isn't recommended for new apps. Installation Plan for Create React App

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 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.

murashki commented 5 months ago

Ukraine and Palestine are not actually today. There is a proposal to pay attention to the Palestinian tragedy.