Upgrading Expo

Guidelines for upgrading Expo SDK versions and fixing dependency issues

49 stars 5 forksMobile Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add robinebers/skills --skill upgrading-expo
Manual install
git clone --depth 1 https://github.com/robinebers/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/upgrading-expo ~/.claude/skills/upgrading-expo

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

## References

- ./references/new-architecture.md -- SDK +53: New Architecture migration guide
- ./references/react-19.md -- SDK +54: React 19 changes (useContext → use, Context.Provider → Context, forwardRef removal)
- ./references/react-compiler.md -- SDK +54: React Compiler setup and migration guide
- ./references/native-tabs.md -- SDK +55: Native tabs changes (Icon/Label/Badge now accessed via NativeTabs.Trigger.\*)
- ./references/expo-av-to-audio.md -- Migrate audio playback and recording from expo-av to expo-audio
- ./references/expo-av-to-video.md -- Migrate video playback from expo-av to expo-video

## Beta/Preview Releases

Beta versions use `.preview` suffix (e.g., `55.0.0-preview.2`), published under `@next` tag.

Check if latest is beta: https://exp.host/--/api/v2/versions (look for `-preview` in `expoVersion`)

```bash
npx expo install expo@next --fix  # install beta
```

## Step-by-Step Upgrade Process

1. Upgrade Expo and dependencies

```bash
npx expo install expo@latest
npx expo install --fix
```

2. Run diagnostics: `npx expo-doctor`

3. Clear caches and reinstall

```bash
npx expo export -p ios --clear
rm -rf node_modules .expo
watchman watch-del-all
```

## Breaking Changes Checklist

- Check for removed APIs in release notes
- Update import paths for moved modules
- Review native module changes requiring prebuild
- Test all camera, audio, and video features
- Verify navigation still works correctly

## Prebuild for Native Changes
Read the full skill on GitHub

Details

Skill name
upgrading-expo
Path
skills/upgrading-expo/SKILL.md
Repo updated
25 June 2026

FAQ

What does the Upgrading Expo skill do?

Guidelines for upgrading Expo SDK versions and fixing dependency issues

How do I install the Upgrading Expo skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add robinebers/skills --skill upgrading-expo. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Upgrading Expo popular?

It lives in robinebers/skills, which has 49 GitHub stars and 5 forks.

Related skills

Browse the most popular Claude skills, all mobile development skills, or write your own with the skills generator.