Guidelines for upgrading Expo SDK versions and fixing dependency issues
Detected risks:
The upgrading-expo skill provides a comprehensive guide for upgrading Expo SDK versions and addressing dependency issues. It assists developers in navigating the complexities of upgrading their Expo projects, ensuring that they maintain compatibility with the latest SDK versions while minimizing potential issues. This skill is designed to streamline the upgrade process and resolve common challenges that arise when working with Expo, such as breaking changes, deprecated packages, and native module updates.
Key features of the upgrading-expo skill include a step-by-step upgrade process, diagnostics tools, and specific instructions for dealing with breaking changes and native code requirements. The skill offers references for migrating to new Expo SDK features, such as React 19 changes, NativeTabs updates, and the transition from expo-av to expo-audio and expo-video for media handling. It also includes detailed instructions for managing native builds and clearing caches for both iOS and Android platforms, which are essential for smooth upgrades. Additionally, the skill highlights deprecated packages and provides replacement recommendations to help users keep their codebase up to date.
This skill is intended for developers working with Expo, particularly those who need to upgrade their projects to newer SDK versions. It's suitable for both beginners and experienced developers, as it offers clear instructions and addresses common issues faced during Expo upgrades. Whether you're working on a greenfield Expo project or maintaining an existing one, upgrading-expo provides the necessary tools and guidance to ensure a smooth transition to the latest Expo versions.
To upgrade to the latest Expo SDK version, run the following commands: `npx expo install expo@latest` followed by `npx expo install --fix`. This will update your project and resolve any dependency issues.
If you encounter breaking changes, refer to the breaking changes checklist which includes checking for removed APIs, updating import paths, and verifying that native modules work as expected. Make sure to test key features like camera, audio, and video functionality.
If your project includes `ios/` and/or `android/` directories, you may need to prebuild the native projects by running `npx expo prebuild --clean`. This regenerates the native directories and ensures that your project is properly set up for native builds.
For deprecated packages, the upgrading-expo skill provides a list of recommended replacements. For example, `expo-av` is replaced by `expo-audio` and `expo-video`. Make sure to update your code before removing the deprecated packages.
If you are using a beta version of Expo, you can install it using the command `npx expo install expo@next --fix`. Beta versions are identified by the `.preview` suffix and can be found using the `https://exp.host/--/api/v2/versions` endpoint.
Quick Setup:
.claude/skills/Repository
expo/skills