next.js: Unable to install major packages with Next.js 15 and React 19 RC

Link to the code that reproduces this issue

https://stackblitz.com/edit/nextjs15-react-rc-peer-dep?file=README.md

To Reproduce

  1. Open sample repro at https://stackblitz.com/edit/nextjs15-react-rc-peer-dep?file=README.md (or create a starter app with create-next-app)
  2. Run npm i @mui/material or npm i react-hook-form in the console
  3. Observe the following errors:
❯ npm i @mui/material
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: undefined@undefined
npm ERR! Found: react@19.0.0-rc-02c0e824-20241028
npm ERR! node_modules/react
npm ERR!   react@"19.0.0-rc-02c0e824-20241028" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer react@"^17.0.0 || ^18.0.0 || ^19.0.0" from @mui/material@6.1.5
npm ERR! node_modules/@mui/material
npm ERR!   @mui/material@"*" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! 
npm ERR! For a full report see:
npm ERR! /home/.npm/_logs/2024-10-29T13_29_55_157Z-eresolve-report.txt
❯ npm i react-hook-form
npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: undefined@undefined
npm ERR! Found: react@19.0.0-rc-02c0e824-20241028
npm ERR! node_modules/react
npm ERR!   react@"19.0.0-rc-02c0e824-20241028" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer react@"^16.8.0 || ^17 || ^18 || ^19" from react-hook-form@7.53.1
npm ERR! node_modules/react-hook-form
npm ERR!   react-hook-form@"*" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! 
npm ERR! For a full report see:
npm ERR! /home/.npm/_logs/2024-10-29T13_29_07_240Z-eresolve-report.txt

Current vs. Expected behavior

Unable to install major packages with Next.js 15 due to react RC peer dependency. npm install fails with the “Could not resolve dependency” error (see repro above).

For example, @mui/material uses the following React peer dependency range - ^17.0.0 || ^18.0.0 || ^19.0.0, which fails with the React RC version installed by default from Next.js 15 peer dependencies. The same issue happens with react-hook-form and ^16.8.0 || ^17 || ^18 || ^19 peer dependency range, and also other packages using >=18 peer dependency range.

I’m aware of the following workarounds, but it seems like a major inconvenience and really a blocker for inexperienced developers.

  1. Install with --legacy-peer-deps flag:
npm i --legacy-peer-deps @mui/material
  1. Add React version overrides to package.json:
"overrides": {
  "@mui/material": {
    "react": "19.0.0-rc-69d4b800-20241021",
    "react-dom": "19.0.0-rc-69d4b800-20241021"
  }
}

or

"overrides": {
  "react": "$react",
  "react-dom": "$react-dom"
}
  1. Downgrade react to 18

Provide environment information

Operating System:
  Platform: darwin
  Arch: x64
  Version: Darwin Kernel Version 24.0.0: Tue Sep 24 23:36:30 PDT 2024; root:xnu-11215.1.12~1/RELEASE_X86_64
  Available memory (MB): 32768
  Available CPU cores: 12
Binaries:
  Node: 22.10.0
  npm: 10.9.0
  Yarn: N/A
  pnpm: N/A
Relevant Packages:
  next: 15.0.1 // Latest available version is detected (15.0.1).
  eslint-config-next: 15.0.1
  react: 19.0.0-rc-69d4b800-20241021
  react-dom: 19.0.0-rc-69d4b800-20241021
  typescript: 5.6.3
Next.js Config:
  output: N/A

Which area(s) are affected? (Select all that apply)

Not sure

Which stage(s) are affected? (Select all that apply)

next dev (local), next build (local), next start (local)

Additional context

I’ve also tested with the latest canary (15.0.2-canary.10) and observed the same issue.

About this issue

  • Original URL
  • State: closed
  • Created 2 years ago
  • Reactions: 8
  • Comments: 16 (2 by maintainers)

Most upvoted comments

My bad, missed that. So you want it to work with latest react?

Correct, since React 19 RC is officially supported in Next.js 15. Downgrading to React 18 would prevent developers from ensuring compatibility with the upcoming React 19 GA.

Mui would have to update it’s deps as nextjs is compatible with the react version you have.

This issue is not limited to MUI. I mentioned react-hook-form in the description as another prominent example. 3rd-party libraries with peer dependencies ^19 or >=18 won’t install out of the box, and that’s what this ticket highlights as an issue. The other workarounds I mentioned in the description are not entirely user friendly.

Just downgrade react to version 19 or 18. React isn’t bundled into nextjs it’s just a version number set in the package that npx create-next-app generates.

@Alexander-Wilkins

with no work around, I guess we’ll just have to --force it most of the time?

overrides in package.json would be a safer option

"overrides": {
  "react": "$react",
  "react-dom": "$react-dom"
}

Same issue with react-hot-toast with node 20.

PS C:\Users\*******\nextjs-tutorial> npm install react-hot-toast npm error code ERESOLVE npm error ERESOLVE unable to resolve dependency tree npm error npm error While resolving: nextjs-tutorial-1@0.1.0 npm error Found: react@19.0.0-rc-02c0e824-20241028 npm error node_modules/react npm error react@"19.0.0-rc-02c0e824-20241028" from the root project npm error npm error Could not resolve dependency: npm error peer react@">=16" from react-hot-toast@2.4.1 npm error node_modules/react-hot-toast npm error react-hot-toast@"*" from the root project npm error npm error Fix the upstream dependency conflict, or retry npm error this command with --force or --legacy-peer-deps npm error to accept an incorrect (and potentially broken) dependency resolution. npm error npm error npm error For a full report see: npm error C:\Users\******\AppData\Local\npm-cache\_logs\2024-11-07T09_08_49_773Z-eresolve-report.txt npm error A complete log of this run can be found in: C:\Users\******\AppData\Local\npm-cache\_logs\2024-11-07T09_08_49_773Z-debug-0.log PS C:\Users\******\nextjs-tutorial-1> node -v v20.18.0

EDIT/FIX: I fixed this issue with --force suffix npm i react-hot-toast --force

The way I managed to work around this issue is by building my NextJS app from scratch as opposed to running npx create-next-app. After this, and installing the latest version of next, react and react-dom, I no longer have issue installing @emotion/styled, @emotion/react, @emotion/server and react-hook-form.

Edit: Just realized that by running npm install react@latest react-dom@latest it installs versions 18.3.1, but npx create-next-app generates a package.json with the React 19 versions. Seems thus as though the problem is with react 19.

@Cemalovic this doesn’t fix the issue, but brute forces the dependency into the bundler. It could be causing problems still behind the scenes.

I’m just curious why Next.js team didn’t add the following override to the create-next-app template?

"overrides": {
  "react": "$react",
  "react-dom": "$react-dom"
}

Is there any downside to doing that?

My bad, missed that. So you want it to work with latest react? Mui would have to update it’s deps as nextjs is compatible with the react version you have.