[material-ui] Next.js npm i throws peer dependency error

[PTCoyer]

Related page

https://mui.com/material-ui/integrations/nextjs/

Kind of issue

Broken demo

Issue description

dependancy error when attempting install of mui in nextjs using command:
npm install @mui/material-nextjs @emotion/cache
npm error peer react@">=16.8.0" from @emotion/react@11.13.3
npm error node_modules/@emotion/react
npm error peer @emotion/react@"^11.11.4" from @mui/material-nextjs@6.1.7
npm error node_modules/@mui/material-nextjs
npm error @mui/material-nextjs@"*" from the root project

Context

attempting to install mui in a nextjs project

Search keywords: react 19 nextjs mui react 16 react

[DiegoAndai]

Hey @PTCoyer, thanks for the report.

I can confirm this issue, as npm doesn't recognize React's RC versions (for example 19.0.0-rc.1) as part of the ^19.0.0 range.

May I ask you to try using the --force flag when running npm i? You can also try yarn or pnpm and see if the problem goes away. This is to confirm that the issue is the same.

[DiegoAndai]

Hey @PTCoyer, and anyone who finds this issue.

The root cause is npm doesn't consider 19.0.0-rc.* to be a valid ^19.0.0 version. If you need React 19 before it becomes stable, you have the following options:

• Run npm install with --force or --legacy-peer-deps flags. If React is the only dependency you're having issues with, then this is safe to do. That's why yarn and pnpm allow it.
• Use yarn or pnpm instead of npm

This issue should stop happening once React 19 is stable.

I wouldn't consider this an issue on Material UI's side, and there are two possible workarounds, so I'm closing it.

[github-actions]

This issue has been closed. If you have a similar problem but not exactly the same, please open a new issue.
Now, if you have additional information related to this issue or things that could help future readers, feel free to leave a comment.

Note

@PTCoyer How did we do? Your experience with our support team matters to us. If you have a moment, please share your thoughts in this short Support Satisfaction survey.