upgrading-react-native
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
More from callstackincubator/agent-skills
react-native-best-practices
Provides React Native performance optimization guidelines for FPS, TTI, bundle size, memory leaks, re-renders, and animations. Applies to tasks involving Hermes optimization, JS thread blocking, bridge overhead, FlashList, native modules, or debugging jank and frame drops.
13.6Kgithub
GitHub patterns using gh CLI for pull requests, stacked PRs, code review, branching strategies, and repository automation. Use when working with GitHub PRs, merging strategies, or repository management tasks.
3.7Kvalidate-skills
Validates skills in this repo against agentskills.io spec and Claude Code best practices. Use via /validate-skills command.
2.8Kgithub-actions
GitHub Actions workflow patterns for React Native iOS simulator and Android emulator cloud builds with downloadable artifacts. Use when setting up CI build pipelines or downloading GitHub Actions artifacts via gh CLI and GitHub API.
2.6Kreact-native-brownfield-migration
Provides an incremental adoption strategy to migrate native iOS or Android apps to React Native or Expo using @callstack/react-native-brownfield for initial setup. Use when planning migration steps, packaging XCFramework/AAR artifacts, and integrating them into host apps.
2.0Kreact-native-testing
>
3