upgrading-expo

Guides Expo SDK upgrades and fixes dependency and breaking-change issues.

Updated May 28, 2026
One-click install
npx skills add https://github.com/qbstabletampa-creator/firmware-foundation-studios --skill upgrading-expo-qbstabletampa-creator
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/qbstabletampa-creator/firmware-foundation-studios/tree/main/archive/apps/manna-catch/.agents/skills/upgrading-expo
Command: npx skills add https://github.com/qbstabletampa-creator/firmware-foundation-studios --skill upgrading-expo-qbstabletampa-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an Expo SDK version often breaks dependencies, deprecated packages, and native configurations, leaving developers to hunt through changelogs and migration guides manually. ## Core Features & Use Cases - Step-by-Step Upgrade Workflow: Runs npx expo install expo@latest, npx expo install --fix, and npx expo-doctor diagnostics, then clears caches and handles prebuild for native changes. - Breaking Change Migration References: Provides detailed guides for the New Architecture (SDK 53+), React 19 and React Compiler (SDK 54+), native tabs (SDK 55), and migrating from expo-av to expo-audio and expo-video. - Housekeeping and Deprecation Cleanup: Identifies deprecated packages (expo-av, AsyncStorage, expo-permissions), redundant Metro/PostCSS config, outdated patches, and unnecessary expo.install.exclude entries. - Use Case: When upgrading an app from Expo SDK 53 to SDK 55, use this Skill to update dependencies, migrate audio/video code off expo-av, convert native tabs imports, and enable React Compiler. ## Quick Start Upgrade my Expo project to the latest SDK and fix any dependency or breaking-change issues that come up.

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?▼

Run `npx expo install expo@latest` followed by `npx expo install --fix` to align dependencies, then run `npx expo-doctor` for diagnostics. Clear caches with `npx expo export -p ios --clear` and remove node_modules and .expo before reinstalling.

How to migrate from expo-av to expo-audio and expo-video?▼

Replace Audio.Sound with the useAudioPlayer hook and Audio.Recording with useAudioRecorder from expo-audio, and replace the Video component with VideoView plus useVideoPlayer from expo-video. Note that expo-audio and expo-video use seconds instead of milliseconds.

Does Expo SDK 54 require react-native-worklets?▼

Yes, Expo SDK 54 and later require react-native-worklets for react-native-reanimated to work. Install it with `npx expo install react-native-worklets` after upgrading.

When should I run expo prebuild --clean during an upgrade?▼

Run `npx expo prebuild --clean` only when the upgrade requires native changes and the project has existing ios/ and android/ directories. Projects using Continuous Native Generation without those directories should skip prebuild entirely.

Why does VideoView show a black screen on Android after migrating?▼

Having both expo-av and expo-video installed simultaneously causes black screens on Android. Uninstall expo-av before installing expo-video, and avoid mounting the same player in multiple VideoViews at once.

What changed with native tabs in Expo SDK 55?▼

In SDK 55, Icon, Label, Badge, and VectorIcon are no longer separate imports from expo-router/unstable-native-tabs. They are now accessed as static properties like NativeTabs.Trigger.Icon and NativeTabs.Trigger.Label.