upgrading-react-native

1# Upgrading React Native
2 
3## Overview
4 
5Covers the full React Native upgrade workflow: template diffs via Upgrade Helper, dependency updates, Expo SDK steps, and common pitfalls.
6 
7## Typical Upgrade Sequence
8 
91. **Route**: Choose the right upgrade path via [upgrading-react-native.md][upgrading-react-native]
102. **Diff**: Fetch the canonical template diff using Upgrade Helper via [upgrade-helper-core.md][upgrade-helper-core]
113. **Dependencies**: Assess and update third-party packages via [upgrading-dependencies.md][upgrading-dependencies]
124. **React**: Align React version if upgraded via [react.md][react]
135. **Expo** (if applicable): Apply Expo SDK layer via [expo-sdk-upgrade.md][expo-sdk-upgrade]
146. **Verify**: Run post-upgrade checks via [upgrade-verification.md][upgrade-verification]
15 
16```bash
17# Quick start: detect current version and fetch diff
18npm pkg get dependencies.react-native --prefix "$APP_DIR"
19npm view react-native dist-tags.latest
20 
21# Example: upgrading from 0.76.9 to 0.78.2
22# 1. Fetch the template diff
23curl -L -f -o /tmp/rn-diff.diff \
24  "https://raw.githubusercontent.com/react-native-community/rn-diff-purge/diffs/diffs/0.76.9..0.78.2.diff" \
25  && echo "Diff downloaded OK" || echo "ERROR: diff not found, check versions"
26# 2. Review changed files
27grep -n "^diff --git" /tmp/rn-diff.diff
28# 3. Update package.json, apply native changes, then install + rebuild
29npm install --prefix "$APP_DIR"
30cd "$APP_DIR/ios" && pod install
31…