AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

upgrading-react-native

Upgrades React Native apps to newer versions by applying rn-diff-purge template diffs, updating package.json dependencies, migrating native iOS and Android configuration, resolving CocoaPods and Gradle changes, and handling breaking API updates. Use when upgrading React Native, bumping RN version, updating from RN 0.x to 0.y, or migrating Expo SDK alongside a React Native upgrade.

Original source
callstackincubator
License
MIT
Pinned revision
59e9d17446a248b21d86f078fcd0bd2d36db1ca4

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read callstackincubator--upgrading-react-native at revision 59e9d17446a248b21d86f078fcd0bd2d36db1ca4, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 8

references/upgrading-react-native.md


title: Upgrading React Native impact: HIGH tags: react-native, upgrade, routing

Skill: Upgrading React Native

Router for React Native upgrade workflows. Start with core Upgrade Helper instructions, then apply focused add-ons by project shape.

Prerequisites (All Upgrade Paths)

  • Ensure the repo is clean or on a dedicated upgrade branch.
  • Know which package manager the repo uses (npm, yarn, pnpm, bun).
  • Use Node.js 20.19.4+, Java 17, and Xcode 16.4+ (with Command Line Tools), following https://reactnative.dev/docs/set-up-your-environment.
    • Optional: use Xcodes to manage Xcode versions.
  • Verify active versions before upgrading: node -v, java -version.
  • Verify Android Studio is installed.
  • For iOS, verify Xcode CLI toolchain is in sync (common pitfall after Xcode upgrades):
    • Check:
      • xcode-select --print-path
      • xcodebuild -version
      • xcrun --sdk iphoneos --show-sdk-version
    • If mismatch is suspected, re-point and initialize:
      • sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
      • sudo xcodebuild -runFirstLaunch

Quick Start

  1. Run the Prerequisites (All Upgrade Paths) checklist.
  2. Set APP_DIR to the app folder (. for single-app repos).
  3. Use monorepo-singlerepo-targeting.md if you need help choosing APP_DIR.
  4. Run upgrade-helper-core.md first to anchor changes to rn-diff-purge.
  5. Publish a short plan (ordered phases) before making versioned edits.
  6. Run upgrading-dependencies.md to assess risky packages and migrations.
  7. Apply dependency updates in one pass and run a single install with the repo package manager.
  8. Run react.md when react is upgraded.
  9. Add expo-sdk-upgrade.md only if expo is present in APP_DIR/package.json.
  10. Finish with upgrade-verification.md.

Decision Map

Related Skills