Upgrading Expo

1---
2name: upgrading-expo
3description: "Upgrade Expo SDK versions"
4source: "https://github.com/expo/skills/tree/main/plugins/upgrading-expo"
5risk: safe
6---
7 
8# Upgrading Expo
9 
10## Overview
11 
12Upgrade Expo SDK versions safely, handling breaking changes, dependencies, and configuration updates.
13 
14## When to Use This Skill
15 
16Use this skill when you need to upgrade Expo SDK versions.
17 
18Use this skill when:
19- Upgrading to a new Expo SDK version
20- Handling breaking changes between SDK versions
21- Updating dependencies for compatibility
22- Migrating deprecated APIs to new versions
23- Preparing apps for new Expo features
24 
25## Instructions
26 
27This skill guides you through upgrading Expo SDK versions:
28 
291. **Pre-Upgrade Planning**: Review release notes and breaking changes
302. **Dependency Updates**: Update packages for SDK compatibility
313. **Configuration Migration**: Update app.json and configuration files
324. **Code Updates**: Migrate deprecated APIs to new versions
335. **Testing**: Verify app functionality after upgrade
34 
35## Upgrade Process
36 
37### 1. Pre-Upgrade Checklist
38 
39- Review Expo SDK release notes
40- Identify breaking changes affecting your app
41- Check compatibility of third-party packages
42- Backup current project state
43- Create a feature branch for the upgrade
44 
45### 2. Update Expo SDK
46 
47```bash
48# Update Expo CLI
49npm install -g expo-cli@latest
50 
51# Upgrade Expo SDK
52npx expo install expo@latest
53 
54# Update all Expo packages
55npx expo install --fix
56```
57 
58### 3. Handle Breaking Changes
59 
60- Review migration guides for breaking changes
61- Update deprecated API calls
62- Modify configuration files as needed
63- Update native dependencies if required
64- Test affected features thoroughly
65 
66### 4. Update Dependencies
67 
68```bash
69# Check for outdated packages
70npx expo-doctor
71 
72# Update packages to compatible versions
73npx expo install --fix
74 
75# Verify compatibility
76npx expo-doctor
77```
78 
79### 5. Testing
80 
81- Test core app functionality
82- Verify native modules work correctly
83- Check for runtime errors
84- Test on both iOS and Android
85- Verify app store builds still work
86 
87## Common Issues
88 
89### Dependency Conflicts
90 
91- Use `expo install` instead of `npm install` for Expo packages
92- Check package compatibility with new SDK version
93- Resolve peer dependency warnings
94 
95### Configuration Changes
96 
97- Update `app.json` for new SDK requirements
98- Migrate deprecated configuration options
99- Update native configuration files if needed
100 
101### Breaking API Changes
102 
103- Review API migration guides
104- Update code to use new APIs
105- Test affected features after changes
106 
107## Best Practices
108 
109- Always upgrade in a feature branch
110- Test thoroughly before merging
111- Review release notes carefully
112- Update dependencies incrementally
113- Keep Expo CLI updated
114- Use `expo-doctor` to verify setup
115 
116## Resources
117 
118For more information, see the [source repository](https://github.com/expo/skills/tree/main/plugins/upgrading-expo).
119