expo-dev-client
Build custom Expo development clients for testing native code on physical devices via EAS Build or locally.
- Only needed when using custom native modules, Apple targets (widgets, app clips), or third-party native code not in Expo Go; try Expo Go first with
npx expo start - Supports cloud builds with automatic TestFlight submission or local builds on your machine, outputting
.ipa(iOS) or.apk/.aab(Android) files - Requires
eas.jsonconfiguration with a development profile that setsdevelopmentClient: trueandautoIncrement: true - Once installed, the dev client launcher UI connects to your local Metro bundler via URL or QR code for live development and native code testing
Use EAS Build to create development clients for testing native code changes on physical devices. Use this for creating custom Expo Go clients for testing branches of your app.
Important: When Development Clients Are Needed
Only create development clients when your app requires custom native code. Most apps work fine in Expo Go.
You need a dev client ONLY when using:
- Local Expo modules (custom native code)
- Apple targets (widgets, app clips, extensions)
- Third-party native modules not in Expo Go
Try Expo Go first with npx expo start. If everything works, you don't need a dev client.
EAS Configuration
Ensure eas.json has a development profile:
{
More from expo/skills
building-native-ui
Complete guide for building beautiful apps with Expo Router. Covers fundamentals, styling, components, navigation, animations, patterns, and native tabs.
38.7Knative-data-fetching
Use when implementing or debugging ANY network request, API call, or data fetching. Covers fetch API, React Query, SWR, error handling, caching, offline support, and Expo Router data loaders (`useLoaderData`).
30.6Kexpo-tailwind-setup
Set up Tailwind CSS v4 in Expo with react-native-css and NativeWind v5 for universal styling
26.9Kupgrading-expo
Guidelines for upgrading Expo SDK versions and fixing dependency issues
26.6Kexpo-cicd-workflows
Helps understand and write EAS workflow YAML files for Expo projects. Use this skill when the user asks about CI/CD or workflows in an Expo or EAS context, mentions .eas/workflows/, or wants help with EAS build pipelines or deployment automation.
25.4Kexpo-deployment
Deploying Expo apps to iOS App Store, Android Play Store, web hosting, and API routes
24.9K