Expo CLI

Expo CLI is a command line app that is the main interface between a developer and Expo tools. You'll use it for a variety of tasks, such as:

Creating new projects
Developing your app: running the project server, viewing logs, opening your app in a simulator
Publishing your app JavaScript and other assets and managing releasing them over the air
Building binaries (apk and ipa files) to be uploaded to the App Store and Play Store
Managing Apple Credentials and Google Keystores

You may use the CLI in your terminal or use the web based interface (it opens automatically by default, or you can press d from the CLI to open it on demand). The web interface enables you to use some of the most often used features from a quick-to-use graphical interface. We’ve only scratched the surface of what expo-cli can do so far. Be sure to check out all the possible commands below!

Installation

npm install -g expo-cli

Checking CLI Version

Run expo --version to determine what version you are currently working with.

Commands

The commands listed below are derived from the latest version of Expo CLI. You can view the list of commands available with your version in your terminal using expo --help. To learn more about a specific command and its options use expo [command] --help.

# Usage: expo [command] [options]

Auth

expo login

Alias: expo signin

Option	Description
`-u, --username [string]`	Username
`-p, --password [string]`	Password
`--otp [string]`	One-time password from your 2FA device

This command does not take any options.

Core

expo export

Export the static files of the app for hosting it on a web server

Option	Description
`-p, --public-url [url]`	The public url that will host the static files. (Required)
`-c, --clear`	Clear the Metro bundler cache
`--output-dir [dir]`	The directory to export the static files to. Default directory is `dist`
`-a, --asset-url [url]`	The absolute or relative url that will host the asset files. Default is './assets', which will be resolved against the public-url.
`-d, --dump-assetmap`	Dump the asset map for further processing.
`--dev`	Configure static files for developing locally using a non-https server
`-s, --dump-sourcemap`	Dump the source map for debugging the JS bundle.
`-q, --quiet`	Suppress verbose output.
`-t, --target [env]`	Target environment for which this export is intended. Options are `managed` or `bare`.
`--merge-src-dir [dir]`	A repeatable source dir to merge in.
`--merge-src-url [url]`	A repeatable source tar.gz file URL to merge in.
`--max-workers [num]`	Maximum number of tasks to allow Metro to spawn.
`--experimental-bundle`	export bundles for use with EAS updates.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo init

Create a new Expo project

Alias: expo i

Option	Description
`-t, --template [name]`	Specify which template to use. Valid options are "blank", "tabs", "bare-minimum" or a package on npm (e.g. "expo-template-bare-typescript") that includes an Expo project template.
`--npm`	Use npm to install dependencies. (default when Yarn is not installed)
`--yarn`	Use Yarn to install dependencies. (default when Yarn is installed)
`--no-install`	Skip installing npm packages or CocoaPods.
`--name [name]`	The name of your app visible on the home screen.
`--yes`	Use default options. Same as "expo init . --template blank

expo install

Install a unimodule or other package to a project

Alias: expo add

Option	Description
`--npm`	Use npm to install dependencies. (default when package-lock.json exists)
`--yarn`	Use Yarn to install dependencies. (default when yarn.lock exists)

expo publish

Deploy a project to Expo hosting

Alias: expo p

Option	Description
`-q, --quiet`	Suppress verbose output from the Metro bundler.
`-s, --send-to [dest]`	A phone number or email address to send a link to
`-c, --clear`	Clear the Metro bundler cache
`-t, --target [env]`	Target environment for which this publish is intended. Options are `managed` or `bare`.
`--max-workers [num]`	Maximum number of tasks to allow Metro to spawn.
`--release-channel [release channel]`	The release channel to publish to. Default is 'default'.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo run:android

Run the Android app binary locally

Option	Description
`--no-bundler`	Skip starting the Metro bundler
`-d, --device [device]`	Device name to build the app on
`-p, --port [port]`	Port to start the Metro bundler on. Default: 8081
`--variant [name]`	(Android) build variant
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo run:ios

Run the iOS app binary locally

Option	Description
`--no-bundler`	Skip starting the Metro bundler
`-d, --device [device]`	Device name or UDID to build the app on
`-p, --port [port]`	Port to start the Metro bundler on. Default: 8081
`--scheme [scheme]`	Scheme to build
`--configuration [configuration]`	Xcode configuration to use. Debug or Release. Default: Debug
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo send

Share the project's URL to an email address

Option	Description
`-s, --send-to [dest]`	Email address to send the URL to
`--dev-client`	Experimental: Starts the bundler for use with the expo-development-client
`--scheme [scheme]`	Custom URI protocol to use with a dev client
`-a, --android`	Opens your app in Expo Go on a connected Android device
`-i, --ios`	Opens your app in Expo Go in a currently running iOS simulator on your computer
`-w, --web`	Opens your app in a web browser
`-m, --host [mode]`	lan (default), tunnel, localhost. Type of host to use. "tunnel" allows you to view your link on other networks
`--tunnel`	Same as --host tunnel
`--lan`	Same as --host lan
`--localhost`	Same as --host localhost
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo start

Start a local dev server for the app

Alias: expo r

Option	Description
`-s, --send-to [dest]`	An email address to send a link to
`-c, --clear`	Clear the Metro bundler cache
`--max-workers [num]`	Maximum number of tasks to allow Metro to spawn.
`--dev`	Turn development mode on
`--no-dev`	Turn development mode off
`--minify`	Minify code
`--no-minify`	Do not minify code
`--https`	To start webpack with https protocol
`--no-https`	To start webpack with http protocol
`--dev-client`	Experimental: Starts the bundler for use with the expo-development-client
`--scheme [scheme]`	Custom URI protocol to use with a dev client
`-a, --android`	Opens your app in Expo Go on a connected Android device
`-i, --ios`	Opens your app in Expo Go in a currently running iOS simulator on your computer
`-w, --web`	Opens your app in a web browser
`-m, --host [mode]`	lan (default), tunnel, localhost. Type of host to use. "tunnel" allows you to view your link on other networks
`--tunnel`	Same as --host tunnel
`--lan`	Same as --host lan
`--localhost`	Same as --host localhost
`--offline`	Allows this command to run while offline
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo start:web

Start a Webpack dev server for the web app

Alias: expo web

Option	Description
`--dev`	Turn development mode on
`--no-dev`	Turn development mode off
`--minify`	Minify code
`--no-minify`	Do not minify code
`--https`	To start webpack with https protocol
`--no-https`	To start webpack with http protocol
`-s, --send-to [dest]`	An email address to send a link to
`--dev-client`	Experimental: Starts the bundler for use with the expo-development-client
`--scheme [scheme]`	Custom URI protocol to use with a dev client
`-a, --android`	Opens your app in Expo Go on a connected Android device
`-i, --ios`	Opens your app in Expo Go in a currently running iOS simulator on your computer
`-w, --web`	Opens your app in a web browser
`-m, --host [mode]`	lan (default), tunnel, localhost. Type of host to use. "tunnel" allows you to view your link on other networks
`--tunnel`	Same as --host tunnel
`--lan`	Same as --host lan
`--localhost`	Same as --host localhost
`--offline`	Allows this command to run while offline
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Client

expo client:install:ios

Install Expo Go for iOS on the simulator

Option	Description
`--latest`	Install the latest version of Expo Go, ignoring the current project version.

expo client:install:android

Install Expo Go for Android on a connected device or emulator

Option	Description
`--latest`	Install the latest version of Expo Go, ignore the current project version.

Info

expo config

Show the project config

Option	Description
`-t, --type [type]`	Type of config to show. Options: public, prebuild, introspect
`--full`	Include all project config data
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo diagnostics

Log environment info to the console

This command does not take any options.

expo doctor

Diagnose issues with the project

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo upgrade

Upgrade the project packages and config for the given SDK version

Alias: expo update

Option	Description
`--npm`	Use npm to install dependencies. (default when package-lock.json exists)
`--yarn`	Use Yarn to install dependencies. (default when yarn.lock exists)

Publish

expo publish:history

Log the project's releases

Alias: expo ph

Option	Description
`-c, --release-channel [channel-name]`	Filter by release channel. If this flag is not included, the most recent publications will be shown.
`--count [number-of-logs]`	Number of logs to view, maximum 100, default 5.
`-p, --platform [ios⎮android]`	Filter by platform, android or ios. Defaults to both platforms.
`-s, --sdk-version [version]`	Filter by SDK version e.g. 35.0.0
`-r, --raw`	Produce some raw output.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo publish:details

Log details of a published release

Alias: expo pd

Option	Description
`--publish-id [publish-id]`	Publication id. (Required)
`-r, --raw`	Produce some raw output.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo publish:set

Specify the channel to serve a published release

Alias: expo ps

Option	Description
`-c, --release-channel [channel-name]`	The channel to set the published release. (Required)
`-p, --publish-id [publish-id]`	The id of the published release to serve from the channel. (Required)
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo publish:rollback

Undo an update to a channel

Alias: expo pr

Option	Description
`--channel-id [channel-id]`	This flag is deprecated.
`-c, --release-channel [channel-name]`	The channel to rollback from. (Required)
`-s, --sdk-version [version]`	The sdk version to rollback. (Required)
`-p, --platform [ios⎮android]`	The platform to rollback.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Build

expo build:ios

Build and sign a standalone IPA for the Apple App Store

Alias: expo bi

Option	Description
`-c, --clear-credentials`	Clear all credentials stored on Expo servers.
`--clear-dist-cert`	Remove Distribution Certificate stored on Expo servers.
`--clear-push-key`	Remove Push Notifications Key stored on Expo servers.
`--clear-push-cert`	Remove Push Notifications Certificate stored on Expo servers. Use of Push Notifications Certificates is deprecated.
`--clear-provisioning-profile`	Remove Provisioning Profile stored on Expo servers.
`-r --revoke-credentials`	Revoke credentials on developer.apple.com, select appropriate using --clear-* options.
`--apple-id [login]`	Apple ID username (please also set the Apple ID password as EXPO_APPLE_PASSWORD environment variable).
`-t --type [build]`	Type of build: [archive	simulator].
`--release-channel [channel-name]`	Pull from specified release channel.
`--no-publish`	Disable automatic publishing before building.
`--no-wait`	Exit immediately after scheduling build.
`--team-id [apple-teamId]`	Apple Team ID.
`--dist-p12-path [dist.p12]`	Path to your Distribution Certificate P12 (set password as EXPO_IOS_DIST_P12_PASSWORD environment variable).
`--push-id [push-id]`	Push Key ID (ex: 123AB4C56D).
`--push-p8-path [push.p8]`	Path to your Push Key .p8 file.
`--provisioning-profile-path [.mobileprovision]`	Path to your Provisioning Profile.
`--public-url [url]`	The URL of an externally hosted manifest (for self-hosted apps).
`--skip-credentials-check`	Skip checking credentials.
`--skip-workflow-check`	Skip warning about build service bare workflow limitations.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo build:android

Build and sign a standalone APK or App Bundle for the Google Play Store

Alias: expo ba

Option	Description
`-c, --clear-credentials`	Clear stored credentials.
`--release-channel [channel-name]`	Pull from specified release channel.
`--no-publish`	Disable automatic publishing before building.
`--no-wait`	Exit immediately after triggering build.
`--keystore-path [app.jks]`	Path to your Keystore.
`--keystore-alias [alias]`	Keystore Alias
`--generate-keystore`	[deprecated] Generate Keystore if one does not exist
`--public-url [url]`	The URL of an externally hosted manifest (for self-hosted apps)
`--skip-workflow-check`	Skip warning about build service bare workflow limitations.
`-t --type [build]`	Type of build: [app-bundle	apk].
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo build:web

Build the web app for production

Option	Description
`-c, --clear`	Clear all cached build files and assets.
`--no-pwa`	Prevent webpack from generating the manifest.json and injecting meta into the index.html head.
`-d, --dev`	Turns dev flag on before bundling
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo build:status

Get the status of the latest build for the project

Alias: expo bs

Option	Description
`--public-url [url]`	The URL of an externally hosted manifest (for self-hosted apps).
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Credentials

expo credentials:manager

Manage your credentials

Option	Description
`-p --platform [platform]`	Platform: [android	ios]
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo fetch:ios:certs

Download the project's iOS standalone app signing credentials

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo fetch:android:keystore

Download the project's Android keystore

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo fetch:android:hashes

Compute and log the project's Android key hashes

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo fetch:android:upload-cert

Download the project's Android keystore

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Notifications

expo push:android:upload

Upload an FCM key for Android push notifications

Option	Description
`--api-key [api-key]`	Server API key for FCM.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo push:android:show

Log the value currently in use for FCM notifications for this project

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo push:android:clear

Delete a previously uploaded FCM credential

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Url

expo url

Log a URL for opening the project in Expo Go

Alias: expo u

Option	Description
`-w, --web`	Return the URL of the web app
`--dev-client`	Experimental: Starts the bundler for use with the expo-development-client
`--scheme [scheme]`	Custom URI protocol to use with a dev client
`-a, --android`	Opens your app in Expo Go on a connected Android device
`-i, --ios`	Opens your app in Expo Go in a currently running iOS simulator on your computer
`-w, --web`	Opens your app in a web browser
`-m, --host [mode]`	lan (default), tunnel, localhost. Type of host to use. "tunnel" allows you to view your link on other networks
`--tunnel`	Same as --host tunnel
`--lan`	Same as --host lan
`--localhost`	Same as --host localhost
`--offline`	Allows this command to run while offline
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo url:ipa

Log the download URL for the standalone iOS binary

Option	Description
`--public-url [url]`	The URL of an externally hosted manifest (for self-hosted apps)
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo url:apk

Log the download URL for the standalone Android binary

Option	Description
`--public-url [url]`	The URL of an externally hosted manifest (for self-hosted apps)
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Webhooks

expo webhooks

List all webhooks for a project

Option	Description
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo webhooks:add

Add a webhook to a project

Option	Description
`--url [url]`	URL to request. (Required)
`--event [event-type]`	Event type that triggers the webhook. [build] (Required)
`--secret [secret]`	Secret used to create a hash signature of the request payload, provided in the 'Expo-Signature' header.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo webhooks:remove

Delete a webhook

Option	Description
`--id [id]`	ID of the webhook to remove.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo webhooks:update

Update an existing webhook

Option	Description
`--id [id]`	ID of the webhook to update.
`--url [url]`	URL the webhook will request.
`--event [event-type]`	Event type that triggers the webhook. [build]
`--secret [secret]`	Secret used to create a hash signature of the request payload, provided in the 'Expo-Signature' header.
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Upload

expo upload:android

Upload an Android binary to the Google Play Store

Alias: expo ua

Option	Description
`--latest`	upload the latest build
`--id [id]`	id of the build to upload
`--path [path]`	path to the .apk/.aab file
`--url [url]`	app archive url
`--key [key]`	path to the JSON key used to authenticate with Google Play
`--android-package [android-package]`	Android package name (using expo.android.package from app.json by default)
`--type [archive-type]`	archive type: apk, aab
`--track [track]`	the track of the application to use, choose from: production, beta, alpha, internal, rollout
`--release-status [release-status]`	release status (used when uploading new apks/aabs), choose from: completed, draft, halted, inProgress
`--use-submission-service`	Experimental: Use Submission Service for uploading your app. The upload process will happen on Expo servers.
`--verbose`	Always print logs from Submission Service
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo upload:ios

Unsupported: Use eas submit or Transporter app instead.

Alias: expo ui

Option	Description
`--latest`	upload the latest build (default)
`--id [id]`	id of the build to upload
`--path [path]`	path to the .ipa file
`--url [url]`	app archive url
`--apple-id [apple-id]`	your Apple ID username (you can also set EXPO_APPLE_ID env variable)
`--itc-team-id [itc-team-id]`	App Store Connect Team ID - this option is deprecated, the proper ID is resolved automatically
`--apple-id-password [apple-id-password]`	your Apple ID password (you can also set EXPO_APPLE_PASSWORD env variable)
`--app-name [app-name]`	the name of your app as it will appear on the App Store, this can't be longer than 30 characters (default: expo.name from app.json)
`--company-name [company-name]`	the name of your company, needed only for the first upload of any app to App Store
`--sku [sku]`	a unique ID for your app that is not visible on the App Store, will be generated unless provided
`--language [language]`	primary language (e.g. English, German; run `expo upload:ios --help` to see the list of available languages)
`--public-url [url]`	The URL of an externally hosted manifest (for self-hosted apps)
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Eject

expo customize:web

Eject the default web files for customization

Option	Description
`-f, --force`	Allows replacing existing files
`--offline`	Allows this command to run while offline

expo eject

Create native iOS and Android project files. Learn more: https://docs.expo.io/workflow/customizing/

Option	Description
`--no-install`	Skip installing npm packages and CocoaPods.
`--npm`	Use npm to install dependencies. (default when Yarn is not installed)
`-p, --platform [platform]`	Platforms to sync: ios, android, all. Default: all
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

expo prebuild

Experimental: Create native iOS and Android project files before building natively. Learn more: https://docs.expo.io/workflow/customizing/

Option	Description
`--no-install`	Skip installing npm packages and CocoaPods.
`--clean`	Delete the native folders and regenerate them before applying changes
`--npm`	Use npm to install dependencies. (default when Yarn is not installed)
`--template [template]`	Project template to clone from. File path pointing to a local tar file or a github repo
`-p, --platform [platform]`	Platforms to sync: ios, android, all. Default: all
`--skip-dependency-update [dependencies]`	Preserves versions of listed packages in package.json (comma separated list)
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.

Experimental

expo client:ios

Experimental: build a custom version of Expo Go for iOS using your own Apple credentials

Option	Description
`--apple-id [login]`	Apple ID username (please also set the Apple ID password as EXPO_APPLE_PASSWORD environment variable).
`--config [file]`	Deprecated: Use app.config.js to switch config files instead.