upgrading-expo

Upgrade Expo SDK versions and resolve dependency and migration issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/tDalile/dotfiles --skill upgrading-expo-tdalile
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/tDalile/dotfiles/tree/main/agents/skills/upgrading-expo
Command: npx skills add https://github.com/tDalile/dotfiles --skill upgrading-expo-tdalile

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Provides a clear, repeatable workflow to upgrade Expo SDK versions and resolve the common dependency, native migration, and breaking-change issues that cause builds or runtime failures after upgrades.

Core Features & Use Cases

  • Guided Upgrade Steps: Step-by-step checklist for installing the latest Expo, running diagnostics, clearing caches, and prebuilding when native changes are required.
  • Migration References: Concrete mappings and migration notes for deprecated packages such as expo-av to expo-audio and expo-video, native tabs changes, and React 19/React Compiler adjustments.
  • Native & Cache Handling: Instructions for detecting CNG vs bare workflow, regenerating ios/android via prebuild, and clearing Cocoapods, Xcode, and Gradle caches.
  • Housekeeping & Compatibility Checks: Tips to update app.json/package.json, remove implicit packages, enable React Compiler, and verify New Architecture compatibility.
  • Use Case: Migrate a mid-sized Expo app from SDK 53 to SDK 55, replacing deprecated packages, prebuilding native projects, and validating audio/video and navigation features.

Quick Start

Follow the checklist to install expo@latest, run diagnostics with npx expo-doctor, clear caches, and run npx expo prebuild --clean if native changes are needed.

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 version and fix dependency errors?▼

To upgrade your Expo SDK version, install expo@latest, run diagnostics with npx expo-doctor, resolve dependency mismatches, clear caches, and use npx expo prebuild --clean to regenerate native directories if needed.

What is the best way to replace deprecated packages like expo-av when upgrading Expo?▼

Replacing deprecated packages like expo-av requires migrating to expo-audio and expo-video, updating package.json accordingly, and verifying that your app.json and native configurations reflect the new dependency mappings for the latest Expo SDK.

When do I need to run expo prebuild --clean during an SDK migration?▼

You need to run expo prebuild --clean during an Expo SDK migration when breaking changes require native modifications, allowing you to regenerate the ios and android directories and ensure compatibility with the new SDK version.

Does this Expo upgrade workflow work for bare React Native projects?▼

Yes, this workflow applies to both Expo-managed and bare React Native projects, detecting the CNG versus bare workflow to handle local native builds, clear Gradle and Cocoapods caches, and update package.json configurations correctly.

Why are my builds failing after upgrading to the latest Expo SDK?▼

Builds fail after an Expo SDK upgrade due to dependency conflicts, stale native caches, or breaking changes from deprecated packages, requiring you to clear Xcode and Gradle caches, remove implicit packages, and run npx expo-doctor to diagnose issues.

Do I need to enable React Compiler when upgrading to Expo SDK 55?▼

Upgrading to newer Expo SDKs involves React 19 and React Compiler adjustments, requiring you to update app configurations, verify New Architecture compatibility, and enable the compiler to ensure runtime stability after the migration.