| 1 | # exp [](https://slack.expo.io)
|
| 2 | The Expo Development CLI
|
| 3 |
|
| 4 | If you have problems with the code in this repository, please file issues & bug reports
|
| 5 | at https://github.com/expo/expo. Thanks!
|
| 6 |
|
| 7 | ## Installation
|
| 8 |
|
| 9 | [Installation instructions and documentation here.](https://docs.expo.io/versions/latest/guides/exp-cli.html)
|
| 10 |
|
| 11 | ## Getting Started
|
| 12 |
|
| 13 | 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).
|
| 14 |
|
| 15 | ## Viewing a Project on Your Phone
|
| 16 |
|
| 17 | 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.
|
| 18 |
|
| 19 | ```bash
|
| 20 | $ exp start
|
| 21 | ...
|
| 22 | [exp] Your URL is
|
| 23 |
|
| 24 | exp://3h-xu5.jesse.expo-example.exp.direct
|
| 25 | ```
|
| 26 |
|
| 27 | The server will continue running until you close it.
|
| 28 |
|
| 29 | To view this on your phone, do the following:
|
| 30 |
|
| 31 | * Go get the Expo app on your Android or iOS device. It's available [on the Google Play Store](https://play.google.com/store/apps/details?id=host.exp.exponent) and [on the iOS App Store](https://itunes.com/apps/exponent).
|
| 32 |
|
| 33 | * Run `exp send` to send a link via email or text. You can also use the `--send-to` option when running `exp start`.
|
| 34 |
|
| 35 | * 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!
|
| 36 |
|
| 37 | ## Publishing a Project
|
| 38 |
|
| 39 | To publish something you've made, just follow these steps:
|
| 40 |
|
| 41 | * Create an Expo account or login to an existing one by running `exp login`.
|
| 42 |
|
| 43 | * Run an `exp` server using `exp start`.
|
| 44 |
|
| 45 | * 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.
|
| 46 |
|
| 47 | * 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.
|
| 48 |
|
| 49 | You can publish as many times as you want and it will replace your old version, so don't worry about making a mistake!
|