upgrading-expo

Upgrade Expo SDK versions and fix dependency and native compatibility issues.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/mjamore/ticked-off --skill upgrading-expo-mjamore
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upgrading-expo
Source: https://github.com/mjamore/ticked-off/tree/main/.agents/skills/upgrading-expo
Command: npx skills add https://github.com/mjamore/ticked-off --skill upgrading-expo-mjamore

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This guide reduces the friction and risk of upgrading Expo SDK versions by providing step-by-step commands, cache-cleaning procedures, and a checklist for breaking changes and native compatibility issues.

Core Features & Use Cases

  • Upgrade orchestration: Commands and order of operations to upgrade Expo, install fixes, run diagnostics, and prebuild native code.
  • Compatibility checks: Guidance for React 19 migration, React Compiler enablement, New Architecture considerations, and native module validation.
  • Troubleshooting & housekeeping: Cache clearing, pod and Gradle cleanup, deprecated package replacements, and patch removal to resolve common post-upgrade failures.

Quick Start

Use the upgrading-expo guide to upgrade an Expo project to the latest SDK, run diagnostics, clear caches, prebuild native directories if needed, and verify native module compatibility.

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 version without breaking native builds?

To upgrade an Expo SDK version without build breaks, follow a specific order of operations: run expo CLI upgrade commands, install dependency fixes, clear caches, run diagnostics, and prebuild native code to verify compatibility.

What is the best way to fix dependency and native compatibility issues after an Expo upgrade?

Fixing dependency and native compatibility issues after an Expo upgrade involves clearing project caches, performing pod and Gradle cleanup, replacing deprecated packages, and removing old patches to resolve common post-upgrade failures.

How do I clear cache and repair pods and Gradle when upgrading React Native Expo?

Clearing cache and repairing pods and Gradle during an Expo upgrade requires running specific expo CLI diagnostics and cleanup commands to remove stale native build artifacts and resolve post-upgrade build failures.

Does upgrading Expo SDK require checking React Compiler and New Architecture compatibility?

Yes, upgrading an Expo SDK requires checking React Compiler enablement, New Architecture considerations, and native module validation to ensure React 19 migration and native dependencies remain fully compatible.

When should I run expo CLI prebuild during an SDK upgrade?

Run expo CLI prebuild during an SDK upgrade after installing dependency fixes and clearing caches to regenerate native directories and verify that native module compatibility issues are resolved before local development or CI workflows.

Can I use this Expo upgrade workflow in local development and CI environments?

Yes, this Expo upgrade workflow applies to React Native Expo projects needing SDK upgrades, cache clearing, and prebuild verification in both local development and CI environments to ensure native compatibility.