upgrading-expo

Guides Expo SDK upgrades and fixes dependency and breaking-change issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Upgrading an Expo SDK version often breaks dependencies, deprecated packages, and native configurations, leaving developers to hunt through changelogs and migration guides manually. ## 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. - Breaking Change References: Provides migration guides for React 19, React Compiler, the New Architecture, native tabs, and the expo-av to expo-audio/expo-video transitions. - Housekeeping Checks: Identifies removable packages, outdated patches, redundant Metro/PostCSS config, and stale expo.install.exclude entries. - Use Case: When bumping a React Native app from SDK 53 to SDK 55, use this Skill to update dependencies, migrate expo-av audio code to useAudioPlayer, and convert native tab components to the new NativeTabs.Trigger.* API. ## Quick Start Upgrade my Expo app to the latest SDK and fix any deprecated packages or breaking changes.

Frequently Asked Questions about upgrading-expo

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

FAQPage Schema
How do I upgrade Expo SDK to the latest 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.createAsync` with the `useAudioPlayer` hook and `Audio.Recording` with `useAudioRecorder` from expo-audio. For video, replace the `<Video>` component with `<VideoView>` driven by `useVideoPlayer`, and uninstall expo-av to avoid black screens on Android.

Does Expo SDK 54 require react-native-worklets?

Yes, 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.

Should I run expo prebuild when upgrading SDK versions?

Only run `npx expo prebuild --clean` if `ios/` and `android/` directories exist in your project. Projects using Continuous Native Generation regenerate native projects at build time, so prebuild and bare-workflow cache clearing should be skipped.

Why does my Expo app break after upgrading to SDK 55 native tabs?

In SDK 55, `Icon`, `Label`, `Badge`, and `VectorIcon` moved to static properties on `NativeTabs.Trigger`. Remove the separate imports and use `<NativeTabs.Trigger.Icon />` and related nested components instead.