Modernize React
Operational guides for upgrading React: React 19 upgrade hub, version-to-version migration paths, hydration error fixes, and class-to-hooks modernization.
Last verified · Updated May 22, 2026
React's major versions ship real breaking changes — removed APIs, ref behavior, and renderer changes. This hub links every supported upgrade path plus the workflows for the errors those upgrades surface.
What this covers
Start at the React 19 upgrade hub for the full breaking-change picture, then pick the source-to-target page that matches the version you are on today. Each page includes a repo-inspection prompt, step-by-step migration, test plan, and rollback guidance.
Version timeline
- 19.0.0currentactivereleased 2024-12-05
- 18.xmaintenancereleased 2022-03-29
- 17.xmaintenancereleased 2020-10-20
- 16.xeolreleased 2017-09-26
React migration paths
- Migrate AngularJS to Reacthigh riskMigration
- Migrate React Class Components to Hookslow riskMigration
- React 16 to React 19 Migration Guidehigh riskVersion path
- React 17 to React 19 Migration Guidehigh riskVersion path
- React 18 to React 19 Migration Guidemedium riskVersion path
- Upgrade to React 19medium riskUpgrade hub
- Upgrade to React 19medium riskVersion path
- Fix React Hydration Errorsmedium riskWorkflow
Frequently asked questions
Which React version should I target?
React 19 is the current stable release. If you are on 16 or 17, plan an intermediate stop at 18 to de-risk the concurrent-rendering changes before adopting 19-only APIs.