upgrading-expo

To upgrade Expo SDK safely, resolve dependency issues by checking release notes, running npx expo-doctor diagnostics, clearing caches, reinstalling, and validating native features like camera and audio. This workflow fixes React Native and Expo module breaking changes.

Migrating expo-av requires following module-level migration guides to update import paths to expo-audio and expo-video. After updating dependencies, validate critical audio and video behaviors against the breaking-changes checklist to ensure native features function correctly.

You only run expo prebuild --clean when native directories already exist in your project. If native folders are absent, you should focus on clearing iOS and Android caches and reinstalling dependencies to achieve a clean state.

Upgrading Expo with React 19 involves enabling the React Compiler and adapting to New Architecture behaviors. Targeted migration references provide checklists for removed APIs and updated import paths to ensure compatibility across your React Native modules.

Navigation breaks after an Expo SDK upgrade due to changes in expo-router. You must validate navigation behavior against the breaking-changes checklist and update routing configurations to align with the new SDK's module-level migration requirements.

Yes, you can use npx expo-doctor to run diagnostics and identify dependency or breaking-change issues during an Expo SDK upgrade. It helps pinpoint misaligned dependencies before you clear caches and reinstall for a clean state.