upgrading-expo

Upgrade Expo SDK versions and resolve dependency issues in Expo projects.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/infinite-loop-factory/app-factory --skill upgrading-expo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/infinite-loop-factory/app-factory/tree/main/.agents/skills/upgrading-expo
Command: npx skills add https://github.com/infinite-loop-factory/app-factory --skill upgrading-expo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill guides developers through upgrading Expo SDK versions and resolving dependency issues that commonly disrupt builds and app functionality.

Core Features & Use Cases

  • Guided migrations: Step-by-step instructions for upgrading Expo SDKs, diagnosing breaking changes, and updating related packages.
  • Native workflow readiness: Prebuild guidance, cache cleanup, and patch removal to prepare projects for native builds (iOS/Android).
  • Housekeeping & verification: Recommendations to update app.json, consult release notes, and verify changes with diagnostics tools.

Quick Start

  • Run npx expo install to update Expo packages to the latest versions.
  • Run npx expo doctor to diagnose potential issues.
  • If migrating to native or making native changes, run npx expo prebuild --clean.
  • Clear caches and update project configuration as needed, then re-run diagnostic checks.

Frequently Asked Questions about upgrading-expo

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

FAQPage Schema
How do I upgrade my Expo SDK to the latest version and fix dependency issues?

To upgrade your Expo SDK, run npx expo install to update packages, then npx expo doctor to diagnose dependency issues. Review release notes for breaking changes and update app.json configurations accordingly.

When do I need to run expo prebuild during an SDK migration?

Run npx expo prebuild --clean during an Expo SDK migration when transitioning to native workflows or making native changes. This prepares your project for iOS and Android builds by generating native project files.

Does the Expo SDK upgrade process work for both managed and bare workflows?

Yes, the Expo SDK upgrade process applies to both managed and bare workflows. It covers diagnostics, prebuild guidance, cache cleanup, and removal of deprecated packages to ensure compatibility across different project setups.

What is the best way to diagnose breaking changes after an Expo SDK upgrade?

The best way to diagnose breaking changes after an Expo SDK upgrade is running npx expo doctor. This diagnostic tool identifies potential dependency conflicts and configuration issues caused by deprecated packages.

Why does my Expo build fail after upgrading dependencies, and how do I clear the cache?

Expo builds often fail after upgrading due to cached native dependencies or unresolved conflicts. Clear your project caches, remove deprecated packages, and run npx expo prebuild --clean to regenerate native files cleanly.