rsnext/errors/react-version.md
davidnx ee62acacfe
react-version.md: Update minimum React version for Next.js 13 (#42490)
Updated minimum React version to match information at https://nextjs.org/blog/next-13. This page is the first Google result for "next.js 13 react 17" and the info in it is out of data after Next.js 13 was released.

## Documentation / Examples

- [x] Make sure the linting passes by running `pnpm build && pnpm lint`
- [x] The "examples guidelines" are followed from [our contributing doc](https://github.com/vercel/next.js/blob/canary/contributing/examples/adding-examples.md)
2022-11-04 15:44:22 +00:00

1.3 KiB

Minimum React Version

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, react@18.2.0 and react-dom@18.2.0. 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

npm upgrade react@latest react-dom@latest

Via Yarn

yarn add react@latest react-dom@latest

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

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