eas-update

Configure, publish, test, and debug over-the-air updates for Expo apps with EAS CLI.

Updated Sep 6, 2026
One-click install
npx skills add https://github.com/sombek/fitness-guidance-app --skill eas-update-sombek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eas-update
Source: https://github.com/sombek/fitness-guidance-app/tree/main/mobile/.agents/skills/eas-update
Command: npx skills add https://github.com/sombek/fitness-guidance-app --skill eas-update-sombek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires expo-updates, eas-cli.

What problem does it solve? Delivering JavaScript and asset changes to installed Expo apps normally requires a new native build and app store review. This Skill guides you through EAS Update so you can ship compatible OTA updates to preview, TestFlight, and production builds, and diagnose why an installed build still shows old code. ## Core Features & Use Cases - Guided configuration: Runs eas update:configure correctly, preserving existing app config, eas.json profiles, and native project setups instead of hand-editing runtime versions or channels. - Deliberate publishing: Publishes updates to the right channel, environment, platform, and runtime version, with safeguards against accidental production releases. - Update debugging: Walks through a structured checklist for builds that did not update, covering channel-to-branch mappings, runtime version mismatches, and the two-cold-launch download lifecycle. - Use Case: You shipped a fix to the production channel but TestFlight testers still see the old UI. Use this Skill to verify the channel mapping, runtime version compatibility, and explain the terminate-and-relaunch update flow. ## Quick Start Use the eas-update skill to configure EAS Update in my Expo project and publish a JavaScript fix to the preview channel.

Frequently Asked Questions about eas-update

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

FAQPage Schema
How do I set up EAS Update in an Expo project?

Install expo-updates with npx expo install expo-updates, then run npx eas-cli@latest update:configure from the project root. The CLI handles updates.url, runtime version, and build-profile channels while preserving your existing app config and eas.json profiles.

How do I publish an OTA update with EAS CLI?

Run eas update with the --channel, --message, and --environment flags after confirming the project, platform, and runtime version. SDK 55 and later require an EAS environment so exported code receives the intended variables.

Why does my TestFlight build still show old code after publishing?

Release builds download new updates in the background and apply them on a later restart. Fully terminate the app and reopen it up to two times: one launch downloads the update, the next runs it. Also verify the channel mapping and runtime version match.

Can EAS Update push native code changes to installed apps?

No. EAS Update only delivers JavaScript, styling, and bundled assets compatible with the installed runtime. Native code changes, most native-library additions, and SDK upgrades require a new native build.

What is the difference between a channel and a branch in EAS Update?

A channel is a deployment target embedded in a build at compile time, while a branch is an ordered stream of updates on the server. The channel points to a branch, and eas channel:edit changes that server-side mapping for every build on the channel.