expo-upgrade

Upgrade Expo SDK versions and migrate deprecated packages with guided diagnostics.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/aadilmallick/myfitness-pal-clone --skill expo-upgrade-aadilmallick
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: expo-upgrade
Source: https://github.com/aadilmallick/myfitness-pal-clone/tree/main/.agents/skills/expo-upgrade
Command: npx skills add https://github.com/aadilmallick/myfitness-pal-clone --skill expo-upgrade-aadilmallick

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an Expo SDK involves breaking changes, deprecated packages, native rebuilds, and dependency conflicts that are easy to miss and painful to debug. This Skill provides a structured, step-by-step upgrade process with version-specific migration references so nothing gets overlooked. ## Core Features & Use Cases - Guided upgrade workflow: Runs npx expo install --fix, expo-doctor diagnostics, cache clearing, and prebuild decisions in the correct order, including CNG vs bare workflow detection. - Version-specific migration references: Covers React 19 changes, React Compiler setup, New Architecture, native tabs API changes, expo-av to expo-audio/expo-video migration, and react-navigation to expo-router import rewrites. - Dependency housekeeping: Identifies deprecated packages, outdated patches, redundant Metro/PostCSS config, and Hermes V1 memory regression pitfalls across SDK 55-57. - Use Case: You are upgrading a React Native app from SDK 54 to SDK 57. The Skill walks you through installing the new SDK, fixing dependencies, migrating expo-av audio code to expo-audio hooks, and verifying the build with expo-doctor. ## Quick Start Use the expo-upgrade skill to upgrade this project to the latest Expo SDK and fix any dependency or migration issues.

Frequently Asked Questions about expo-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade an Expo SDK version in my project?

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 before rebuilding.

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

Replace Audio.Sound.createAsync 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 use seconds instead of milliseconds.

Should I upgrade directly to SDK 57 or go through SDK 56?

Upgrade directly to SDK 57 with [email protected] or later, skipping SDK 56. SDK 55 with Hermes V1, SDK 56, and early SDK 57 releases contain a Hermes V1 memory regression affecting react-native-worklets and react-native-reanimated.

Does Expo SDK 54 support React Compiler?

Yes, React Compiler is stable in Expo SDK 54 and later. Enable it by adding experiments.reactCompiler set to true in app.json, after which manual useMemo, useCallback, and React.memo calls can be removed.

When should I run expo prebuild during an upgrade?

Run npx expo prebuild --clean only if ios/ and android/ directories exist in the project. If neither exists, the project uses Continuous Native Generation and native projects regenerate automatically at build time.

Why do I get a black screen with expo-video on Android?

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