Skill

upgrading-expo

Guides Expo SDK upgrades: reviews release notes/breaking changes, updates deps/config with expo install --fix and expo-doctor, migrates APIs, tests iOS/Android.

React Native

iOS

Android

Javascript

mobile

npx claudepluginhub absjaded/antigravity-awesome-skills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Upgrade Expo SDK versions safely, handling breaking changes, dependencies, and configuration updates.

SKILL.md

Similar Skills

finishing-a-development-branch

174.6k

Verifies tests pass on completed feature branch, presents options to merge locally, create GitHub PR, keep as-is or discard; executes choice and cleans up worktree.

superpowers

systematic-debugging

174.6k

Guides root cause investigation for bugs, test failures, unexpected behavior, performance issues, and build failures before proposing fixes.

10 files

superpowers

writing-plans

174.6k

Writes implementation plans from specs for multi-step tasks, mapping files and breaking into TDD bite-sized steps before coding.

1 file

superpowers

Stats

Stars0

Forks0

Last CommitFeb 27, 2026

Used By7 plugins

Actions

View Source View Plugin View on GitHub View README

Upgrading Expo

Overview

Upgrade Expo SDK versions safely, handling breaking changes, dependencies, and configuration updates.

When to Use This Skill

Use this skill when you need to upgrade Expo SDK versions.

Use this skill when:

Upgrading to a new Expo SDK version
Handling breaking changes between SDK versions
Updating dependencies for compatibility
Migrating deprecated APIs to new versions
Preparing apps for new Expo features

Instructions

This skill guides you through upgrading Expo SDK versions:

Pre-Upgrade Planning: Review release notes and breaking changes
Dependency Updates: Update packages for SDK compatibility
Configuration Migration: Update app.json and configuration files
Code Updates: Migrate deprecated APIs to new versions
Testing: Verify app functionality after upgrade

Upgrade Process

1. Pre-Upgrade Checklist

Review Expo SDK release notes
Identify breaking changes affecting your app
Check compatibility of third-party packages
Backup current project state
Create a feature branch for the upgrade

2. Update Expo SDK

# Update Expo CLI
npm install -g expo-cli@latest

# Upgrade Expo SDK
npx expo install expo@latest

# Update all Expo packages
npx expo install --fix

3. Handle Breaking Changes

Review migration guides for breaking changes
Update deprecated API calls
Modify configuration files as needed
Update native dependencies if required
Test affected features thoroughly

4. Update Dependencies

# Check for outdated packages
npx expo-doctor

# Update packages to compatible versions
npx expo install --fix

# Verify compatibility
npx expo-doctor

5. Testing

Test core app functionality
Verify native modules work correctly
Check for runtime errors
Test on both iOS and Android
Verify app store builds still work

Common Issues

Dependency Conflicts

Use expo install instead of npm install for Expo packages
Check package compatibility with new SDK version
Resolve peer dependency warnings

Configuration Changes

Update app.json for new SDK requirements
Migrate deprecated configuration options
Update native configuration files if needed

Breaking API Changes

Review API migration guides
Update code to use new APIs
Test affected features after changes

Best Practices

Always upgrade in a feature branch
Test thoroughly before merging
Review release notes carefully
Update dependencies incrementally
Keep Expo CLI updated
Use expo-doctor to verify setup

Resources

For more information, see the source repository.