No documentation on migrating Pages Router from v14 to v15

[yurkimus]

Summary

I cannot find any official informating regarding updraging Pages Router to NextJS of version 15.

Could you give me any idea how I do so and is there any limitation? May I use React of version 18 since the 19-th mignt not work with App Router?

Additional information

No response

Example

No response

[icyJoseph]

Hi,

I guess you need to start here, https://nextjs.org/docs/app/guides/upgrading/version-15, what's needed for v15 App Router?

• The minimum versions of react and react-dom is now 19.

Alright, but what does it mean for Pages Router? From the release docs, https://nextjs.org/blog/next-15#react-19:

In version 15, the App Router uses React 19 RC, and we've also introduced backwards compatibility for React 18 with the Pages Router based on community feedback. If you're using the Pages Router, this allows you to upgrade to React 19 when ready.

So what you can do is, upgrade to next 15, and upgrade your Pages Router Stack to React 19. https://nextjs.org/blog/next-15#pages-router-on-react-18, just don't overlap them:

Note: While it is possible to run the Pages Router on React 18 and the App Router on React 19 in the same application, we don't recommend this setup.

Do the jump to React 19 first, then migrate to App Router, https://nextjs.org/docs/app/guides/migrating/app-router-migration

[yurkimus]

Thank you for the response.

I have seen the information in the blog about Pages Router compatability already. the reason I have asked the question was that I didn't see such important information in the guidelines within the docs.

The migration is not always done in one step, so your detail here is crucial: "Do the jump to React 19 first, then migrate to App Router". It's always a step-by-step process when working with "big" apps.

Tbh, I am not considering using NextJS v15, since I have tried that and wasn't satisfied with the DX and some technical decisions. In the same time I would like to continue upgrading React and get the latest core updates if there some.