ContextQMD
Back to Next Js

Minimum React Version

errors/react-version.mdx

16.2.51.3 KB
Original Source

Why This Error Occurred

Your project is using an old version of react or react-dom that does not meet the suggested minimum version requirement.

Next.js suggests using, at a minimum, [email protected] and [email protected]. Older versions of react and react-dom do work with Next.js, however, they do not enable all of Next.js' features.

For example, the following features are not enabled with old React versions:

  • Fast Refresh: instantly view edits to your app without losing component state
  • Component stack trace in development: see the component tree that lead up to an error
  • Hydration mismatch warnings: trace down discrepancies in your React tree that cause performance problems

This list is not exhaustive, but illustrative in the value of upgrading React!

Possible Ways to Fix It

Via npm

bash
npm upgrade react@latest react-dom@latest

Via Yarn

bash
yarn add react@latest react-dom@latest

Manually Open your package.json and upgrade react and react-dom:

json
{
  "dependencies": {
    "react": "^18.2.0",
    "react-dom": "^18.2.0"
  }
}