Antigravity Skills - Build and Discover AI Agent SkillsAntigravity Skills

Upgrading Expo Skill · Development

Upgrade Expo SDK Versions Safely

Upgrade Expo SDK versions safely with our 5-step process.

Handle breaking changes, dependencies, and configuration updates. Get your app ready for new features.

  • Expo
  • React Native
  • SDK Upgrade
  • Mobile Development
  • Dependency Management

About This Skill

This skill provides a 5-step process to upgrade Expo SDK versions safely, covering pre-upgrade planning, dependency updates, configuration migration, code updates, and testing. It includes 3 key commands for CLI updates and package management.

Quick Start

  1. 1Review Expo SDK release notes and identify breaking changes
  2. 2Update Expo CLI and run npx expo install expo@latest
  3. 3Run npx expo-doctor to verify compatibility
Example Command
npx expo install expo@latest

Core Capabilities

Pre-Upgrade Planning

Review release notes, identify breaking changes, check third-party compatibility, and backup your project.

Dependency Updates

Update Expo packages and dependencies to compatible versions using npx expo install --fix.

Configuration Migration

Update app.json and configuration files to match the new SDK requirements.

Code Updates

Migrate deprecated API calls to new versions and modify code for breaking changes.

Testing

Verify core app functionality, native modules, and runtime errors after upgrade.

Usage Examples

Before

Expo SDK 49 with deprecated AppLoading component

After

Expo SDK 50 using expo-splash-screen instead of AppLoading

Input

Check for outdated packages after upgrade

Output

Ran npx expo-doctor and updated all incompatible packages.

Input

Handle breaking change in react-native-maps

Output

Updated import paths and configuration per migration guide.

SKILL.md

---
name: upgrading-expo
description: "Upgrade Expo SDK versions"
risk: safe
source: "https://github.com/expo/skills/tree/main/plugins/upgrading-expo"
date_added: "2026-02-27"
---

# 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:

1. **Pre-Upgrade Planning**: Review release notes and breaking changes
2. **Dependency Updates**: Update packages for SDK compatibility
3. **Configuration Migration**: Update app.json and configuration files
4. **Code Updates**: Migrate deprecated APIs to new versions
5. **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

```bash
# 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

```bash
# 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 erro

Frequently Asked Questions

FAQ

Which Expo SDK versions does this skill support?
This skill supports upgrading any Expo SDK version, from older versions like 45 up to the latest. It covers the general process of reviewing release notes, handling breaking changes, and updating dependencies for any target version.
Who is this skill for?
This skill is for React Native developers and mobile app teams using Expo who need to upgrade their SDK version safely. It's suitable for both beginners and experienced developers.
How is this different from just running npx expo install?
While npx expo install updates packages, this skill provides a structured 5-step process including pre-upgrade planning, handling breaking changes, configuration migration, code updates, and testing—ensuring a complete and safe upgrade.
Does this skill support languages other than JavaScript/TypeScript?
The skill is designed for JavaScript and TypeScript projects using Expo. It covers code updates for both languages, including type definitions and configuration files.
What results can I expect after using this skill?
You can expect a successful upgrade to the target Expo SDK version with all dependencies compatible, deprecated APIs migrated, and core app functionality verified through testing. The skill helps avoid common runtime errors and breaking changes.

Discussion

Discussion

0 comments
U

On This Page

Trigger Phrases

Use these phrases to activate this skill in your AI coding assistant:

upgrade Expo SDKupdate Expo versionExpo breaking changesmigrate Expo SDKExpo dependency updateExpo configuration migration