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!