eas-update

Configure, publish, test, and debug over-the-air JavaScript updates with expo-updates and EAS CLI.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/CYRUS-pinto/pi-bot --skill eas-update-cyrus-pinto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eas-update
Source: https://github.com/CYRUS-pinto/pi-bot/tree/main/.agents/skills/eas-update
Command: npx skills add https://github.com/CYRUS-pinto/pi-bot --skill eas-update-cyrus-pinto

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Delivering JavaScript, styling, 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 push compatible over-the-air 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 state 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 do not update, covering channel-to-branch mapping, runtime version mismatches, and the two-cold-launch download lifecycle. - Use Case: You shipped a TestFlight build and fixed a JavaScript bug. Use this Skill to publish the fix to the preview channel, verify it with up to two cold launches, then promote the same update to production. ## Quick Start Use the eas-update skill to configure EAS Update in my Expo project and publish a JavaScript-only 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 npx eas-cli@latest update with the --channel, --message, and --environment flags. SDK 55 and later require an EAS environment. Confirm the project, channel, platform, and runtime version before publishing, especially to production.

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

Release builds download 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, platform, and runtime version match.

Can EAS Update push native code changes to existing builds?

No. EAS Update only delivers JavaScript, styling, and bundled assets compatible with the installed runtime version. 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; a branch is an ordered stream of updates. On the server, a channel points to a branch, and eas channel:edit changes that mapping for every build on the channel.