Expo

Get Started
Feature Preview

Creating Development Builds

With EAS

You can set up your project to use EAS by running
eas build:configure
If you have not installed EAS CLI yet, you can do so by running npm install -g eas-cli.
This command will create an eas.json file. If you have an existing eas.json file that does not have a "development" profile already, edit the file to add one:
{
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    }
  }
}
This profile has two options set:
  • Setting developmentClient to true will create a Debug build, which allows the expo-dev-client library to allow you to choose the update to load in your app and provide tools to help you develop.
  • Setting distribution to "internal" will make a build ready for internal distribution.

To create and share a development build with your team, you can run the following:
eas build --profile development --platform android
To share the build with your team, direct them to the build page on https://expo.dev. There, they'll be able to download the app directly on their device.
To allow iOS devices to run a build built for internal distribution, you'll have to register each iOS device you'd like to install your development build on.
You can register an iOS device and install a provisioning profile with the following command:
eas device:create
Once you've registered all iOS devices you'll want to run your development build on, you can run the following to create a build ready for internal distribution:
eas build --profile development --platform ios
To share the build with your team, direct them to the build page on https://expo.dev. There, they'll be able to download the app directly on their device.
Note: If you register any new iOS devices, you'll need create a new development build. Learn more about internal distribution.

If you are comfortable setting up Xcode, Android Studio, and related dependencies, you can build and distribute your app the same as any other iOS or Android app.
The expo run commands will create a new build, install it on to your emulator or device, and start it running.
To build and run on an emulator
expo run:android
To build and run on a connected device
expo run:android -d
To build and run on a simulator
expo run:ios
To build and run on a connected device
expo run:ios -d