Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Next.js and React

npx create-react-app prints a deprecation message or will not set up a new project

Errorcreate-react-app is deprecated.

Short answer

Create React App was deprecated by the React team in February 2025 and has no active maintainers. A new install prints a deprecation notice that points to React's framework list. Start new projects with a framework, or with Vite, and check that your Node.js version meets Vite's minimum.

  • Applies to Node.js 22, npm 10, Vite 7, React 19
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Read the message in full. If it says create-react-app is deprecated, the tool is not broken in your setup; it is retired for new apps. Also check your Node.js version.

    node --version
    npm --version
  2. 2Match what you see, then jump to its fix

    1. 1create-react-app is deprecated. You can find a list of up-to-date React frameworks on react.devCreate React App is deprecated for new appsFix
    2. 2Vite or npm prints an engine or version warning, or the dev server refuses to start.Node.js is too old for the replacement toolFix

What does the error look like?

  • create-react-app is deprecated.
  • This error message will only be shown once per install.

Cause 1 of 2

Create React App is deprecated for new apps

1Check

React announced the deprecation, because the project has no active maintainers. It stays in maintenance mode, and a version was published to work with React 19.

node --version

2Fix

Create the app with a framework, or with Vite for a plain client-side app. The React docs list Next.js, React Router and Expo as framework starters.

npm create vite@latest my-app -- --template react
cd my-app
npm install
npm run dev

3Verify

The dev server starts and prints a local URL.

npm run dev

Confirmed by react.dev

Did this fix it?

Cause 2 of 2

Node.js is too old for the replacement tool

1Check

Vite documents the Node.js versions it needs. Compare yours with it.

node --version

2Fix

Upgrade Node.js to 20.19 or newer, or 22.12 or newer, then scaffold again. Some templates may need a newer one.

# after upgrading Node.js with your usual tool
node --version
npm create vite@latest my-app -- --template react

3Verify

The scaffold finishes without engine warnings.

node --version

Confirmed by vite.dev

Did this fix it?

How do I stop it coming back?

  • Start new apps from the React docs page for new projects, which lists the current recommendations.
  • Write the required Node.js version in the project README, so every machine uses a supported one.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Projects of mine built on the same technologies:

Related fixes

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.