upgrading-react-native

Upgrading React Native

Overview

Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.

Typical Upgrade Sequence

Route: Choose the right upgrade path via [upgrading-react-native.md][upgrading-react-native]
Diff: Fetch the canonical template diff using Upgrade Helper via [upgrade-helper-core.md][upgrade-helper-core]
Dependencies: Assess and update third-party packages via [upgrading-dependencies.md][upgrading-dependencies]
React: Align React version if upgraded via [react.md][react]
Expo (if applicable): Apply Expo SDK layer via [expo-sdk-upgrade.md][expo-sdk-upgrade]
Verify: Run post-upgrade checks via [upgrade-verification.md][upgrade-verification]

# Quick start: detect current version and fetch diff
npm pkg get dependencies.react-native --prefix "$APP_DIR"
npm view react-native dist-tags.latest
 
# Example: upgrading from 0.76.9 to 0.78.2
# 1. Fetch the template diff

When to Apply

Reference these guidelines when:

Moving a React Native app to a newer version
Reconciling native config changes from Upgrade Helper
Validating release notes for breaking changes

Quick Reference

File	Description
[upgrading-react-native.md][upgrading-react-native]	Router: choose the right upgrade path
[upgrade-helper-core.md][upgrade-helper-core]	Core Upgrade Helper workflow and reliability gates
[upgrading-dependencies.md][upgrading-dependencies]	Dependency compatibility checks and migration planning
[react.md][react]	React and React 19 upgrade alignment rules
[expo-sdk-upgrade.md][expo-sdk-upgrade]	Expo SDK-specific upgrade layer (conditional)
[upgrade-verification.md][upgrade-verification]	Post-upgrade verification checklist, including agent-device-assisted checks
[monorepo-singlerepo-targeting.md][monorepo-singlerepo-targeting]	Monorepo and single-repo app targeting and command scoping

Problem → Skill Mapping

Problem	Start With
Need to upgrade React Native	[upgrade-helper-core.md][upgrade-helper-core]
Need dependency risk triage and migration options	[upgrading-dependencies.md][upgrading-dependencies]
Need React/React 19 package alignment	[react.md][react]
Need workflow routing first	[upgrading-react-native.md][upgrading-react-native]
Need Expo SDK-specific steps	[expo-sdk-upgrade.md][expo-sdk-upgrade]
Need manual or agent-assisted regression validation	[upgrade-verification.md][upgrade-verification]
Need repo/app command scoping	[monorepo-singlerepo-targeting.md][monorepo-singlerepo-targeting]

Upgrading React Native

Overview

Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.

Typical Upgrade Sequence

Route: Choose the right upgrade path via [upgrading-react-native.md][upgrading-react-native]
Diff: Fetch the canonical template diff using Upgrade Helper via [upgrade-helper-core.md][upgrade-helper-core]
Dependencies: Assess and update third-party packages via [upgrading-dependencies.md][upgrading-dependencies]
React: Align React version if upgraded via [react.md][react]
Expo (if applicable): Apply Expo SDK layer via [expo-sdk-upgrade.md][expo-sdk-upgrade]
Verify: Run post-upgrade checks via [upgrade-verification.md][upgrade-verification]

# Quick start: detect current version and fetch diff
npm pkg get dependencies.react-native --prefix "$APP_DIR"
npm view react-native dist-tags.latest
 
# Example: upgrading from 0.76.9 to 0.78.2
# 1. Fetch the template diff

When to Apply

Reference these guidelines when:

Moving a React Native app to a newer version
Reconciling native config changes from Upgrade Helper
Validating release notes for breaking changes

Quick Reference

File	Description
[upgrading-react-native.md][upgrading-react-native]	Router: choose the right upgrade path
[upgrade-helper-core.md][upgrade-helper-core]	Core Upgrade Helper workflow and reliability gates
[upgrading-dependencies.md][upgrading-dependencies]	Dependency compatibility checks and migration planning
[react.md][react]	React and React 19 upgrade alignment rules
[expo-sdk-upgrade.md][expo-sdk-upgrade]	Expo SDK-specific upgrade layer (conditional)
[upgrade-verification.md][upgrade-verification]	Post-upgrade verification checklist, including agent-device-assisted checks
[monorepo-singlerepo-targeting.md][monorepo-singlerepo-targeting]	Monorepo and single-repo app targeting and command scoping

Problem → Skill Mapping

Problem	Start With
Need to upgrade React Native	[upgrade-helper-core.md][upgrade-helper-core]
Need dependency risk triage and migration options	[upgrading-dependencies.md][upgrading-dependencies]
Need React/React 19 package alignment	[react.md][react]
Need workflow routing first	[upgrading-react-native.md][upgrading-react-native]
Need Expo SDK-specific steps	[expo-sdk-upgrade.md][expo-sdk-upgrade]
Need manual or agent-assisted regression validation	[upgrade-verification.md][upgrade-verification]
Need repo/app command scoping	[monorepo-singlerepo-targeting.md][monorepo-singlerepo-targeting]