1---2name: upgrading-expo3description: Upgrade Expo SDK versions4---56# Upgrading Expo78## Overview910Upgrade Expo SDK versions safely, handling breaking changes, dependencies, and configuration updates.1112## When to Use This Skill1314Use this skill when you need to upgrade Expo SDK versions.1516Use this skill when:17- Upgrading to a new Expo SDK version18- Handling breaking changes between SDK versions19- Updating dependencies for compatibility20- Migrating deprecated APIs to new versions21- Preparing apps for new Expo features2223## Instructions2425This skill guides you through upgrading Expo SDK versions:26271. **Pre-Upgrade Planning**: Review release notes and breaking changes282. **Dependency Updates**: Update packages for SDK compatibility293. **Configuration Migration**: Update app.json and configuration files304. **Code Updates**: Migrate deprecated APIs to new versions315. **Testing**: Verify app functionality after upgrade3233## Upgrade Process3435### 1. Pre-Upgrade Checklist3637- Review Expo SDK release notes38- Identify breaking changes affecting your app39- Check compatibility of third-party packages40- Backup current project state41- Create a feature branch for the upgrade4243### 2. Update Expo SDK4445```bash46# Update Expo CLI47npm install -g expo-cli@latest4849# Upgrade Expo SDK50npx expo install expo@latest5152# Update all Expo packages53npx expo install --fix54```5556### 3. Handle Breaking Changes5758- Review migration guides for breaking changes59- Update deprecated API calls60- Modify configuration files as needed61- Update native dependencies if required62- Test affected features thoroughly6364### 4. Update Dependencies6566```bash67# Check for outdated packages68npx expo-doctor6970# Update packages to compatible versions71npx expo install --fix7273# Verify compatibility74npx expo-doctor75```7677### 5. Testing7879- Test core app functionality80- Verify native modules work correctly81- Check for runtime errors82- Test on both iOS and Android83- Verify app store builds still work8485## Common Issues8687### Dependency Conflicts8889- Use `expo install` instead of `npm install` for Expo packages90- Check package compatibility with new SDK version91- Resolve peer dependency warnings9293### Configuration Changes9495- Update `app.json` for new SDK requirements96- Migrate deprecated configuration options97- Update native configuration files if needed9899### Breaking API Changes100101- Review API migration guides102- Update code to use new APIs103- Test affected features after changes104105## Best Practices106107- Always upgrade in a feature branch108- Test thoroughly before merging109- Review release notes carefully110- Update dependencies incrementally111- Keep Expo CLI updated112- Use `expo-doctor` to verify setup113114## Resources115116For more information, see the [source repository](https://github.com/expo/skills/tree/main/plugins/upgrading-expo).
Run npx skillmds add nimoqup046-collab/upgrading-expo in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Upgrade Expo SDK versions It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
nimoqup046-collab (@nimoqup046-collab) published this skill. Their other Agent Skills are listed on their SkillMD profile.
nimoqup046-collab