exp

The Expo Development CLI

If you have problems with the code in this repository, please file issues & bug reports at https://github.com/expo/expo. Thanks!

Installation

Installation instructions and documentation here.

Getting Started

To make a new project use exp init [path]. The path is optional and it will use the current directory if not specified (all commands that need a path behave similarly).

Viewing a Project on Your Phone

To view a project you must have an exp server running for that project. Run exp start [path] to start running the server. Once it is ready it'll output a url for your project.

$ exp start
...
[exp] Your URL is

exp://3h-xu5.jesse.expo-example.exp.direct

The server will continue running until you close it.

To view this on your phone, do the following:

• Go get the Expo app on your Android or iOS device. It's available on the Google Play Store and on the iOS App Store.

• Run exp send to send a link via email or text. You can also use the --send-to option when running exp start.

• Check your e-mail or texts and tap the link. The Expo app should open and you should be able to view your experience there!

Publishing a Project

To publish something you've made, just follow these steps:

• Create an Expo account or login to an existing one by running exp login.

• Run an exp server using exp start.

• Check to make sure you can load your app by sending the link to yourself with exp send and opening it in the Expo app.

• Once everything looks good, run exp publish. A few seconds later, you should get a clean URL sent to you that points to the exp.host server where your package was published to.

You can publish as many times as you want and it will replace your old version, so don't worry about making a mistake!