This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

Expo DevClient iconExpo DevClient

A library that allows creating a development build and includes useful development tools.

Android
iOS
tvOS
Recommended version:
~55.0.40

expo-dev-client adds various useful development tools to your debug builds:

Expo documentation refers to debug builds that include expo-dev-client as development builds.

Installation

Terminal
- npx expo install expo-dev-client
- yarn expo install expo-dev-client
- pnpm expo install expo-dev-client
- bun expo install expo-dev-client

If you are installing this in an existing React Native app, start by installing expo in your project. Then, follow the instructions from Install expo-dev-client in an existing React Native project.

Configuration in app config

You can configure development client launcher using its built-in config plugin if you use config plugins in your project (Continuous Native Generation (CNG)). The plugin allows you to configure various properties that cannot be set at runtime and require building a new app binary to take effect. If your app does not use CNG, then you'll need to manually configure the library.

Example app.json with config plugin

app.json
{ "expo": { "plugins": [ [ "expo-dev-client", { "launchMode": "most-recent" } ] ] } }

Configurable properties

NameDefaultDescription
launchMode"most-recent"

Determines whether to launch the most recently opened project or navigate to the launcher screen.

  • most-recent - Attempt to launch directly into a previously opened project and if unable to connect, fall back to the launcher screen.
  • launcher - Opens the launcher screen.
addGeneratedSchemetrue

By default, expo-dev-client will register a custom URL scheme to open a project. Set this property to false to disable this scheme.

android.launchMode"most-recent"
Only for: 
Android

Determines whether to launch the most recently opened project or navigate to the launcher screen on Android. Overrides the top-level launchMode setting for Android only.

  • most-recent - Attempt to launch directly into a previously opened project and if unable to connect, fall back to the launcher screen.
  • launcher - Opens the launcher screen.
ios.launchMode"most-recent"
Only for: 
iOS

Determines whether to launch the most recently opened project or navigate to the launcher screen on iOS. Overrides the top-level launchMode setting for iOS only.

  • most-recent - Attempt to launch directly into a previously opened project and if unable to connect, fall back to the launcher screen.
  • launcher - Opens the launcher screen.

TV support

  • This library is only supported for TV in SDK 54 and later.
    • Android TV: All operations are supported, similar to an Android phone.
    • Apple TV: Basic operations with a local or tunneled packager are supported. Authentication to EAS and listing of EAS builds and updates is not yet supported.

API

import * as DevClient from 'expo-dev-client';

No API data file found, sorry!