expo-upgrade

Guides step-by-step Expo SDK upgrades with breaking-change fixes and dependency migrations.

16|1|Updated May 5, 2026
One-click install
npx skills add https://github.com/AIBiz-Automatyzacje/workspace-template-mobile --skill expo-upgrade-aibiz-automatyzacje
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: expo-upgrade
Source: https://github.com/AIBiz-Automatyzacje/workspace-template-mobile/tree/main/.claude/skills/expo-upgrade
Command: npx skills add https://github.com/AIBiz-Automatyzacje/workspace-template-mobile --skill expo-upgrade-aibiz-automatyzacje

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an Expo SDK version often breaks apps through deprecated packages, changed APIs, native module issues, and cache problems. This Skill provides a structured, step-by-step upgrade process that handles breaking changes, dependency fixes, and migration of deprecated packages like expo-av. ## Core Features & Use Cases - Guided Upgrade Process: Runs the correct sequence of commands (expo install, expo-doctor, cache clearing, prebuild) for a safe SDK upgrade. - Breaking Change References: Includes detailed migration guides for React 19, New Architecture, React Compiler, native tabs, expo-av to expo-audio/expo-video, and react-navigation to expo-router. - Housekeeping & Cleanup: Identifies deprecated packages, outdated patches, redundant Metro/PostCSS config, and expo.install.exclude workarounds to remove after upgrading. - Use Case: When asked to migrate a project from SDK 54 to SDK 57, the Skill walks through dependency updates, Hermes V1 memory regression warnings, codemods for react-navigation imports, and post-upgrade validation. ## Quick Start Upgrade my Expo project to the latest SDK and fix any breaking changes that come up.

Frequently Asked Questions about expo-upgrade

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

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 switch from milliseconds to seconds.

Does Expo SDK 54 support React 19 and React Compiler?

Yes, Expo SDK 54 includes React 19 and stable React Compiler support. Enable the compiler by adding experiments.reactCompiler: true to app.json, which removes the need for manual useMemo and useCallback.

Why does my app use excessive memory after upgrading Expo SDK?

SDK 55 with Hermes V1, SDK 56, 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.

Can I still use @react-navigation imports with Expo SDK 56?

No, SDK 56 requires repointing @react-navigation/* imports to expo-router entry points like expo-router/react-navigation or expo-router/js-stack. Run the npx expo-codemod sdk-56-expo-router-react-navigation-replace codemod to automate the rewrite.

When should I run expo prebuild during an upgrade?

Run npx expo prebuild --clean only when ios/ or 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 this step.