Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
Upgrades React Native apps to newer versions using rn-diff-purge diffs, updates package.json, migrates iOS/Android config, resolves CocoaPods and Gradle changes, and handles breaking API updates.
npx claudepluginhub callstackincubator/agent-skills --plugin react-native-best-practicesHow this skill is triggered — by the user, by Claude, or both
Slash command
/upgrading-react-native:upgrading-react-nativeThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.
Upgrades React Native apps using rn-diff-purge diffs, updates dependencies, migrates iOS/Android configs, resolves CocoaPods/Gradle changes, and handles breaking APIs including Expo SDK.
Guides React Native and Expo SDK version upgrades via 5-step process: pre-assessment, core updates, dependency management, breaking change migrations, and verification.
Guides Expo SDK upgrades: reviews release notes/breaking changes, updates dependencies with expo install --fix and expo-doctor, migrates configs/APIs, tests iOS/Android compatibility.
Share bugs, ideas, or general feedback.
Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.
# 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
curl -L -f -o /tmp/rn-diff.diff \
"https://raw.githubusercontent.com/react-native-community/rn-diff-purge/diffs/diffs/0.76.9..0.78.2.diff" \
&& echo "Diff downloaded OK" || echo "ERROR: diff not found, check versions"
# 2. Review changed files
grep -n "^diff --git" /tmp/rn-diff.diff
# 3. Update package.json, apply native changes, then install + rebuild
npm install --prefix "$APP_DIR"
cd "$APP_DIR/ios" && pod install
# 4. Validate: both platforms must build successfully
npx react-native build-android --mode debug --no-packager
xcodebuild -workspace "$APP_DIR/ios/App.xcworkspace" -scheme App -sdk iphonesimulator build
Reference these guidelines when:
| File | Description |
|---|---|
| upgrading-react-native.md | Router: choose the right upgrade path |
| upgrade-helper-core.md | Core Upgrade Helper workflow and reliability gates |
| upgrading-dependencies.md | Dependency compatibility checks and migration planning |
| react.md | React and React 19 upgrade alignment rules |
| expo-sdk-upgrade.md | Expo SDK-specific upgrade layer (conditional) |
| upgrade-verification.md | Post-upgrade verification checklist, including agent-device-assisted checks |
| monorepo-singlerepo-targeting.md | Monorepo and single-repo app targeting and command scoping |
| Problem | Start With |
|---|---|
| Need to upgrade React Native | upgrade-helper-core.md |
| Need dependency risk triage and migration options | upgrading-dependencies.md |
| Need React/React 19 package alignment | react.md |
| Need workflow routing first | upgrading-react-native.md |
| Need Expo SDK-specific steps | expo-sdk-upgrade.md |
| Need manual or agent-assisted regression validation | upgrade-verification.md |
| Need repo/app command scoping | monorepo-singlerepo-targeting.md |