upgrading-expo

Guide Expo SDK version upgrades with dependency and prebuild steps.

52|22|Updated Nov 9, 2022
One-click install
npx skills add https://github.com/satsigner/satsigner --skill upgrading-expo-satsigner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/satsigner/satsigner/tree/main/.cursor/skills/upgrading-expo
Command: npx skills add https://github.com/satsigner/satsigner --skill upgrading-expo-satsigner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides clear, opinionated guidance to upgrade Expo SDK versions and resolve dependency, native, and tooling breakages that commonly block React Native/Expo project upgrades.

Core Features & Use Cases

  • Step-by-step upgrade process: Instructions to update Expo, run diagnostics, clear caches, and regenerate native prebuilds when required.
  • Dependency and API migrations: Guidance for replacing deprecated packages (for example migrating expo-av to expo-audio/video), enabling the React Compiler, and removing implicit packages.
  • Native and Metro cleanup: Advice for pod repo updates, Gradle/Xcode cache cleaning, metro/babel config simplification, and handling the New Architecture.
  • Use Case: Ideal for maintainers upgrading an app from SDK 53/54 to newer SDK versions who need a checklist of breaking changes, package replacements, and prebuild steps to produce a working native build.

Quick Start

Generate a tailored upgrade plan for my Expo project that lists required dependency changes, cache-clearing steps, prebuild commands, and verification checks.

Frequently Asked Questions about upgrading-expo

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade my Expo SDK to a newer version?

To upgrade an Expo SDK, update dependencies, run diagnostics, clear metro and babel caches, and regenerate native projects using npx expo prebuild. This process resolves dependency and native-breaking issues to produce a working build.

What is the best way to migrate expo-av to expo-audio and expo-video?

Migrating expo-av involves replacing the deprecated package with the new expo-audio and expo-video packages. You must update your dependencies, adjust import statements, and verify API compatibility with the new Expo SDK version.

How do I clear Gradle and Xcode caches when upgrading React Native prebuilds?

Clearing Gradle and Xcode caches involves removing cached build artifacts and pod repositories before running npx expo prebuild. This ensures native projects regenerate cleanly without stale dependencies blocking the upgrade.

Do I need to update app.json experiments and sdkVersion for an Expo migration?

Yes, updating app.json experiments and sdkVersion handling is required for an Expo migration. You must align these configurations with the new SDK version to satisfy technical requirements and ensure compatibility with new architecture features.

Why does my Expo build break after updating to a new SDK version?

Expo builds break after an SDK update due to dependency conflicts, deprecated packages, and stale native prebuilds. Resolving these issues requires updating dependencies, simplifying metro config, and regenerating native code.