upgrading-expo

Guides Expo SDK upgrades and migrates deprecated APIs across React Native projects.

Updated Mar 29, 2026
One-click install
npx skills add https://github.com/Divith123/Flamingo --skill upgrading-expo-divith123
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/Divith123/Flamingo/tree/main/.agents/skills/upgrading-expo
Command: npx skills add https://github.com/Divith123/Flamingo --skill upgrading-expo-divith123

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an Expo SDK version often breaks dependencies, native modules, and deprecated APIs like expo-av, leaving developers to manually hunt through changelogs and fix cryptic build errors. ## Core Features & Use Cases - Step-by-Step Upgrade Workflow: Runs npx expo install --fix, expo-doctor diagnostics, cache clearing, and prebuild steps in the correct order for both CNG and bare workflow projects. - Breaking Change Migration Guides: Provides detailed references for React 19 changes, React Compiler setup, the New Architecture, native tabs restructuring, and expo-av to expo-audio/expo-video migrations. - Housekeeping and Cleanup: Identifies removable packages, outdated patches, redundant Metro/PostCSS config options, and stale 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 audio/video code off expo-av, convert native tabs imports, and verify the New Architecture works. ## Quick Start Upgrade my Expo project to the latest SDK version and fix any deprecated API usage and dependency 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 reinstall node_modules if issues persist.

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. For video, replace the Video component with VideoView paired with useVideoPlayer from expo-video, noting that time values switch from milliseconds to seconds.

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

Run it only when upgrading requires native changes and your project has existing ios/ or android/ directories. Projects using Continuous Native Generation without those directories regenerate native projects at build time and should skip this step.

Why does VideoView show a black screen on Android?▼

This happens when both expo-av and expo-video are installed simultaneously, or when the same player is mounted in multiple VideoViews. Uninstall expo-av first and avoid reusing one player across multiple views on Android.

What changed in React 19 for Expo SDK 54?▼

React 19 replaces useContext with the use hook, removes the .Provider suffix from Context components, and eliminates forwardRef by allowing ref as a regular prop. These patterns should be updated during the SDK 54 upgrade.