upgrading-expo

Guide Expo SDK upgrades with a checklist for dependency and migration changes.

34|2|Updated Aug 16, 2025
One-click install
npx skills add https://github.com/FilenCloudDienste/filen-ts --skill upgrading-expo-filenclouddienste
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/FilenCloudDienste/filen-ts/tree/main/.claude/skills/upgrading-expo
Command: npx skills add https://github.com/FilenCloudDienste/filen-ts --skill upgrading-expo-filenclouddienste

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you upgrade Expo SDK versions safely by providing a practical checklist for dependency issues, breaking changes, and common migration pitfalls.

Core Features & Use Cases

  • Step-by-step upgrade flow: upgrade Expo, run diagnostics, clear caches, and reinstall to reduce “mysterious” build/runtime errors.
  • Breaking changes checklist: verify removed APIs, moved modules/import paths, native module requirements, and functionality like camera/audio/video and navigation.
  • Targeted migration references: React 19 changes, New Architecture behavior, React Compiler setup, NativeTabs changes, expo-av to expo-audio/video migrations, and react-navigation to expo-router import repointing.
  • Prebuild and cache management guidance: decide when to run expo prebuild, and how to clear native caches for bare workflow apps.

Quick Start

Follow the step-by-step upgrade process for your target Expo SDK, starting with upgrading Expo and dependencies, then running expo-doctor, clearing caches, and reinstalling to catch issues early.

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 without breaking React Native dependencies?

To upgrade your Expo SDK safely, follow an ordered checklist: upgrade Expo and dependencies first, run expo-doctor for diagnostics, clear caches, and reinstall to catch build and runtime errors early.

What breaking changes should I check for when migrating to a new Expo SDK?

When migrating to a new Expo SDK, verify removed APIs, moved module import paths, native module requirements, and functionality changes affecting camera, audio, video, and navigation to prevent unexpected breakage.

How do I migrate from expo-av to expo-audio and expo-video during an SDK upgrade?

Migrating from expo-av to expo-audio and expo-video requires updating import paths and API calls according to targeted migration references that map old module functionality to the new separate audio and video packages.

Do I need to run expo prebuild and clear native caches when upgrading Expo SDK?

Running expo prebuild and clearing native caches is necessary for bare workflow apps during an Expo SDK upgrade to remove stale native code and ensure the generated iOS and Android folders match the new SDK configuration.

How do I handle React 19 and New Architecture changes when upgrading Expo?

Handle React 19 and New Architecture changes during an Expo upgrade by applying targeted migration references that address React Compiler setup, native module behavior differences, and required configuration updates.

Why does my React Native app break after an Expo SDK upgrade?

Your React Native app breaks after an Expo SDK upgrade due to dependency version mismatches, uncleared native caches, and breaking changes like moved import paths or removed APIs that require systematic migration fixes.