---
modificationDate: June 29, 2026
title: DevClient
description: A library that allows creating a development build and includes useful development tools.
sourceCodeUrl: 'https://github.com/expo/expo/tree/sdk-57/packages/expo-dev-client'
packageName: 'expo-dev-client'
iconUrl: '/static/images/packages/expo-dev-client.png'
platforms: ['android', 'ios', 'tvos']
---

<AgentInstructions>

## Submitting Feedback

If this page contains errors, outdated information, or gaps that blocked you from completing a task, report it so the docs can be improved:

curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/versions/v57.0.0/sdk/dev-client/","feedback":"🤖 Agent feedback for docs: <specific, actionable description> (<model>, <harness>)"}'

Only submit when you have something specific and actionable to report. Replace <model> with the model you are running as and <harness> with the tool you are running in (for example, Claude Code, Cursor, Codex CLI).

## Navigation

When answering a related or follow-up question, use llms.txt to find the relevant page as Markdown (.md) instead of guessing.

You are here: Reference (v57.0.0) > Expo SDK (86 pages in this section)
Full documentation tree: [llms.txt](https://docs.expo.dev/llms.txt)

</AgentInstructions>

# Expo DevClient

A library that allows creating a development build and includes useful development tools.
Android, iOS, tvOS

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

-   A configurable launcher UI, so you can launch updates (such as from [PR previews](/develop/development-builds/development-workflows.md#pr-previews)) and switch between development servers without needing to recompile the native app
-   Improved debugging tools (such as support for [inspecting network requests](/debugging/tools.md#inspecting-network-requests))
-   [A powerful and extensible developer menu UI](/debugging/tools.md#developer-menu)

Expo documentation refers to debug builds that include `expo-dev-client` as [development builds](/develop/development-builds/introduction.md).

## Installation

```sh
# npm
npx expo install expo-dev-client

# yarn
yarn expo install expo-dev-client

# pnpm
pnpm expo install expo-dev-client

# bun
bun expo install expo-dev-client
```

If you are installing this in an [existing React Native app](/bare/overview.md), start by installing [`expo`](/bare/installing-expo-modules.md) in your project. Then, follow the instructions from [Install `expo-dev-client` in an existing React Native project](/bare/install-dev-builds-in-bare.md).

## Configuration in app config

You can configure development client launcher using its built-in [config plugin](/config-plugins/introduction.md) if you use config plugins in your project ([Continuous Native Generation (CNG)](/workflow/continuous-native-generation.md)). 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

```json
{
  "expo": {
    "plugins": [
      [
        "expo-dev-client",
        {
          "launchMode": "most-recent",
          "defaultLaunchURL": "http://localhost:8081",
          "android": {
            "defaultLaunchURL": "http://10.0.0.2:8081"
          }
        }
      ]
    ]
  }
}
```

### Configurable properties

| Name | Default | Description |
| --- | --- | --- |
| `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.

 |
| `addGeneratedScheme` | `true` | By default, `expo-dev-client` will register a custom URL scheme to open a project. Set this property to `false` to disable this scheme. |
| `defaultLaunchURL` | - | Launch directly into this URL instead of navigating to launcher screen. If `launchMode` is set to `most-recent`, then launcher will use the `defaultLaunchURL` as a fallback. |
| `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.

 |
| `android.defaultLaunchURL` | - | Only for: Android. Instead of navigating to launcher screen launch directly into this URL. If `launchMode` is set to `most-recent`, then launcher will use the `defaultLaunchURL` as a fallback. |
| `ios.defaultLaunchURL` | - | Only for: iOS. Instead of navigating to launcher screen launch directly into this URL. If `launchMode` is set to `most-recent`, then launcher will use the `defaultLaunchURL` as a fallback. |

## 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

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

## Methods

### `DevClient.closeMenu()`

A method that closes development client menu when called.

Returns: `void`

### `DevClient.hideMenu()`

A method that hides development client menu when called.

Returns: `void`

### `DevClient.openMenu()`

A method that opens development client menu when called.

Returns: `void`

### `DevClient.registerDevMenuItems(items)`

| Parameter | Type |
| --- | --- |
| `items` | [ExpoDevMenuItem[]](#expodevmenuitem) |

  

A method that allows to specify custom entries in the development client menu.

Returns: `Promise<void>`

## Types

### `ExpoDevMenuItem`

An object representing the custom development client menu entry.

| Property | Type | Description |
| --- | --- | --- |
| callback | `() => void` | Callback to fire, when user selects an item. |
| name | `string` | Name of the entry, will be used as label. |
| shouldCollapse(optional) | `boolean` | A boolean specifying if the menu should close after the user interaction. Default: `false` |