hanzoai/next.js
2
0
Fork 0
mirror of https://github.com/hanzoai/next.js.git synced 2026-09-24 17:00:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

In-Depth Explanation of React Version Handling Doc (#89426)

Browse Source 
There have been multiple discussions and some confusion around [React
version handling](https://nextjs.org/docs#react-version-handling) in
Next.js. This PR adds an in-depth explanation to clarify how React and
react-dom versions are managed internally, and why they still need to be
declared in package.json.

The goal is to help developers better understand this behavior and
reduce recurring questions around it.

Reference discussion:
https://github.com/vercel/next.js/discussions/87958

@icyJoseph

---------

Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
Co-authored-by: Joseph <[email protected]>
Co-authored-by: Joseph <[email protected]>
This commit is contained in:
Abhishek Mardiya
2026-02-23 10:40:10 +01:00
committed by GitHub
co-authored by vercel[bot] <35613825+vercel[bot]@users.noreply.github.com> Joseph Joseph
parent 351a67529b
commit 757ab17e54
1 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/01-app/01-getting-started/01-installation.mdx
+4 -1
View File
@@ -126,7 +126,10 @@ yarn add next@latest react@latest react-dom@latest
bun add next@latest react@latest react-dom@latest
```
> **Good to know**: The App Router uses [React canary releases](https://react.dev/blog/2023/05/03/react-canaries) built-in, which include all the stable React 19 changes, as well as newer features being validated in frameworks. The Pages Router uses the React version you install in `package.json`.
> **Good to know**:
>
> - The `App Router` uses [React canary releases](https://react.dev/blog/2023/05/03/react-canaries) built-in, which include all the stable React 19 changes, as well as newer features being validated in frameworks, but you should still declare react and react-dom in package.json for tooling and ecosystem compatibility.
> - The `Pages Router` uses the React version from your `package.json`.
Then, add the following scripts to your `package.json` file: