upgrading-react-native

SKILL.md

Orchestrates React Native version upgrades with template diffs, dependency resolution, and native platform migration.

Applies canonical rn-diff-purge template diffs to align native iOS and Android configuration with target React Native versions

Handles package.json dependency updates, CocoaPods and Gradle changes, and breaking API migrations across major and minor version bumps

Includes Expo SDK upgrade layer for managed Expo projects and post-upgrade verification checklist

Provides structured workflow routing: choose upgrade path, fetch diff, assess dependencies, align React version, validate builds on both platforms

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