upgrading-expo

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

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/Ahmed-Eldalatony/airbnb-clone-bench --skill upgrading-expo-ahmed-eldalatony
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/Ahmed-Eldalatony/airbnb-clone-bench/tree/main/.agents/skills/upgrading-expo
Command: npx skills add https://github.com/Ahmed-Eldalatony/airbnb-clone-bench --skill upgrading-expo-ahmed-eldalatony

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. This Skill provides a structured upgrade process with diagnostics, cache clearing, and migration references so the upgrade completes without guesswork. ## 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 reinstalls dependencies. - Breaking Change Migration Guides: Includes references for the New Architecture (SDK 53+), React 19 changes (SDK 54), React Compiler setup, native tabs API changes (SDK 55), and expo-av to expo-audio/expo-video migrations. - Housekeeping and Cleanup: Identifies deprecated packages, removable config files (babel.config.js, metro.config.js), outdated patches, and obsolete expo.install.exclude entries. - Use Case: When upgrading a React Native app from Expo SDK 53 to SDK 55, use this Skill to update dependencies, migrate expo-av audio/video code, convert native tabs components, and enable React Compiler. ## Quick Start Upgrade my Expo app to the latest SDK version and fix any dependency or breaking-change issues.

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 do I 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 function. Install it with npx expo install react-native-worklets after upgrading.

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

Run npx expo prebuild --clean only when the upgrade requires native changes and the ios/ or android/ directories exist in the project. Projects using Continuous Native Generation regenerate native projects at build time and should skip this step.

Why does VideoView show a black screen on Android after migrating to expo-video?

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 in native tabs for Expo SDK 55?

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