expo-upgrade

Upgrades Expo SDK versions and migrates deprecated packages and APIs.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/bmiit145/leadBee --skill expo-upgrade-bmiit145
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: expo-upgrade
Source: https://github.com/bmiit145/leadBee/tree/main/mobile/.agents/skills/expo-upgrade
Command: npx skills add https://github.com/bmiit145/leadBee --skill expo-upgrade-bmiit145

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. This Skill provides a structured upgrade process with per-version migration references so upgrades complete without regressions. ## Core Features & Use Cases - Step-by-Step Upgrade Workflow: Runs npx expo install --fix, expo-doctor diagnostics, cache clearing, and conditional prebuild for native changes. - Version-Specific Migration Guides: References cover React 19 changes, React Compiler, New Architecture, native tabs, expo-av to expo-audio/expo-video, and react-navigation to expo-router migrations. - Dependency Housekeeping: Identifies deprecated packages, outdated patches, redundant Metro/PostCSS config, and unnecessary expo.install.exclude entries. - Use Case: When moving an app from SDK 54 to SDK 57, follow the checklist to update dependencies, migrate audio/video code off expo-av, enable React Compiler, and avoid the Hermes V1 memory regression. ## 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?▼

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

Does Expo SDK 54 support React Compiler?▼

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

Why does my Expo app use more memory after upgrading to SDK 56?▼

SDK 55 with Hermes V1, all SDK 56 releases, and SDK 57 before expo@57.0.9 contain a Hermes V1 memory regression triggered by react-native-worklets or react-native-reanimated. Upgrade directly to SDK 57 with expo@57.0.9 or later.

When should I run expo prebuild during an upgrade?▼

Run `npx expo prebuild --clean` only when the upgrade requires native changes and the project does not use Continuous Native Generation. If no ios/ or android/ directories exist, native projects regenerate at build time and prebuild can be skipped.

How do I migrate react-navigation imports to expo-router in SDK 56?▼

Run the codemod `npx expo-codemod sdk-56-expo-router-react-navigation-replace` over your source directory, or manually repoint @react-navigation/* imports to matching expo-router entry points like expo-router/react-navigation or expo-router/js-stack.