expo-dev-client

Build and distribute Expo development clients locally or via TestFlight using EAS Build.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Expo Go cannot run custom native code, local Expo modules, Apple targets, or third-party native libraries, so developers need a way to build and install custom development clients on physical devices for real testing. ## Core Features & Use Cases - EAS Development Profiles: Configure eas.json with developmentClient, autoIncrement, and remote app version settings for consistent builds. - Cloud and Local Builds: Build iOS and Android dev clients via EAS Build in the cloud or locally with Xcode and Android toolchains. - TestFlight Distribution: Build and submit iOS dev clients to TestFlight in one command for internal team testing. - Use Case: Your app adds a config plugin and push notifications that Expo Go cannot run. Use this Skill to create a development build, install it on your device, and connect it to your local Metro bundler. ## Quick Start Use the expo-dev-client skill to configure a development profile in eas.json and build an iOS development client for my device.

Frequently Asked Questions about expo-dev-client

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

FAQPage Schema
How do I build an Expo development client?

Run eas build with a development profile that sets developmentClient to true in eas.json. Use eas build -p ios --profile development for cloud builds, or add --local to build on your own machine with Xcode or Android tools.

When do I need a development client instead of Expo Go?

You need a dev client when using local Expo modules, custom native code, Apple targets like widgets or app clips, third-party native modules not bundled in Expo Go, config plugins, or when testing remote push notifications and universal links.

How do I submit an Expo dev client to TestFlight?

Run eas build -p ios --profile development --submit to build the dev client in the cloud and automatically submit it to App Store Connect. You receive an email when the build is ready in TestFlight, which requires a paid Apple Developer account.

Can I build an Expo dev client locally for free?

Yes, local builds are free since expo-dev-client is open source. Run eas build with the --local flag to produce an .ipa for iOS or .apk/.aab for Android, then install via simctl, ideviceinstaller, or adb.

Why does my EAS build fail with signing errors?

Signing errors usually come from missing or invalid credentials. Run eas credentials to configure certificates and provisioning profiles, or use --clear-cache if stale build artifacts cause failures.

How do I connect a dev client to my local Metro bundler?

Start Metro with npx expo start --dev-client, then scan the QR code with the dev client or enter the bundler URL manually. The dev client launcher UI lets you switch between development servers.