upgrade-react-native

Upgrade React Native Version

Upgrades the React Native version in the SalesforceMobileSDK-ReactNative and SalesforceMobileSDK-Templates repos.

When to Use

When bumping React Native from one minor/patch version to another (e.g., 0.84.x → 0.85.x) as part of the SDK's regular RN upgrade cadence.

Parameters

• OLD_VERSION: Current RN version (e.g., 0.84.1)
• NEW_VERSION: Target RN version (e.g., 0.85.3)
• BRANCH: Feature branch name (e.g., rn-upgrade-0.85)
• FORK_USER: GitHub username for the personal fork (e.g., wmathurin)

Process

---

Phase 1: Pre-Checks

1a. Find the latest patch

curl -s "https://registry.npmjs.org/react-native" | python3 -c "
import sys, json
data = json.load(sys.stdin)
versions = [v for v in data['versions'] if v.startswith('NEW_MINOR.')]
print('Latest:', versions[-1])
"

1b. Check React peer dep for the new version

curl -s "https://registry.npmjs.org/react-native/NEW_VERSION" | python3 -c "
import sys, json; d=json.load(sys.stdin)
print('React peer dep:', d['peerDependencies'].get('react'))
"

1c. Grep for removed/deprecated APIs in our source

Check the RN release blog for removed APIs, then grep:

# Examples from past upgrades — always check the release notes for the actual list
grep -r "StyleSheet\.absoluteFillObject" src/ test/
grep -r "CatalystInstanceImpl\|NativeViewHierarchyManager\|ReactTextUpdate\|UIManagerHelper" android/
grep -r "RCTHostRuntimeDelegate" ios/
grep -r "preset.*react-native" --include="*.json" --include="*.js" .

If any hits: fix before bumping. If clean: proceed.

---

Phase 2: Version Bumps — ReactNative repo

Edit these files, replacing OLD_VERSION → NEW_VERSION everywhere:

File	Fields
package.json	peerDependencies["react-native"], devDependencies["@react-native/*"]
iosTests/package.json	dependencies["react-native"], devDependencies["@react-native/*"], dependencies["react-native-force"] URL #rn-upgrade-OLD → #rn-upgrade-NEW
androidTests/package.json	same as iosTests
android/build.gradle	react-android:OLD_VERSION → react-android:NEW_VERSION
androidTests/android/app/build.gradle.kts	react-android:OLD, hermes-android:OLD → NEW