skills.rest
sombek
sombekCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

expo-upgrade

Upgrades Expo SDK versions and migrates deprecated packages with step-by-step diagnostics.

Updated Sep 6, 2026
Search Tags:#dependency management#migration#react native#react 19#expo#expo-router#sdk upgrade
One-click install
npx skills add https://github.com/sombek/fitness-guidance-app --skill expo-upgrade-sombek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: expo-upgrade
Source: https://github.com/sombek/fitness-guidance-app/tree/main/mobile/.agents/skills/expo-upgrade
Command: npx skills add https://github.com/sombek/fitness-guidance-app --skill expo-upgrade-sombek

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 upgrade process with per-version migration guides so nothing gets overlooked. ## Core Features & Use Cases - Guided Upgrade Workflow: Runs npx expo install --fix, expo-doctor diagnostics, cache clearing, and prebuild steps in the correct order, with CNG vs bare workflow detection. - Version-Specific Migration References: Covers React 19 changes, React Compiler setup, New Architecture, native tabs, expo-av to expo-audio/expo-video, and react-navigation to expo-router migrations. - Housekeeping & Cleanup: Identifies deprecated packages, redundant Metro/PostCSS config, outdated patches, and Hermes V1 memory regression pitfalls. - Use Case: When moving a project from SDK 54 to SDK 57, use this Skill to upgrade dependencies, migrate expo-av audio code to expo-audio hooks, enable React Compiler, and verify the app 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 remove node_modules before reinstalling.

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, noting that expo-video uses 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 excessive memory after upgrading to SDK 56?▼

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

When should I run expo prebuild during an SDK upgrade?▼

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

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 on your source directory, or manually repoint @react-navigation/* imports to expo-router entry points like expo-router/react-navigation and expo-router/js-stack. Then remove unused @react-navigation packages.

Related Skills

Explore More Software Engineering Skills→
bmiit145bmiit145

expo-upgrade

Upgrades Expo SDK versions and migrates deprecated packages and APIs.

Community
Advanced
cristianbc2004cristianbc2004

expo-deployment

Automate Expo app deployment to iOS, Android, and web via EAS.

Community
Advanced
GGEduGGEdu

canary-watch

Monitor deployed URLs to detect HTTP, performance, and content regressions.

Community
Intermediate
MinhmiceMinhmice

upgrading-expo

Guide Expo SDK upgrades with dependency validation and native configuration checks.

Community
Intermediate