Expo Docs

Hey friend! We are co-hosting a conference with Software Mansion, learn more.

Up and Running

The aim of this first guide is to get an Expo application up and running as quickly as possible.
At this point we should have XDE installed on our development machine and the Expo client on an iOS or Android physical device or emulator. If not, go back to the Installation guide before proceeding.
Alright, let's get started.

Upon opening XDE you will be prompted for a username and password. Fill this in with your desired username and password and hit continue -- if the username isn't already taken, then we will automatically create the account for you.

Press Project and select New Project, then choose the Tab Navigation option since that will give us a good starting point, then enter the name of your project in the dialog that pops up. I'll call mine first-project, and press create.
Next, choose where to save the project. I keep all of my fun projects in ~/coding, so I navigate to that directory and press open.
XDE is now initializing a new project in selected directory: it copies a basic template and installs react, react-native and expo.
When the project is initialized and ready to go you will see the message "React packager ready" in the XDE logs.
The "React packager" is a simple HTTP server that compiles our app JavaScript code using Babel and serves it to the Expo app.
Note: If you are on MacOS and XDE gets stuck on "Waiting for packager and tunnel to start", you may need to install watchman on your machine. The easiest way to do this is with Homebrew, brew install watchman.

The fastest way to see your app on your device is to open the Expo Client mobile app and log in to the same account you're using in XDE. Once you log in, a link to your project will automatically appear inside Expo Client on your phone.
Alternatively, press Share, enter your phone number, and press Send Link. Open the message on your phone and tap on the link to open it in Expo. You can share this link with anybody else who has the Expo app installed, but it will only be available as long as you have the project open in XDE.
To open the app in the iOS simulator you can press the Device button and choose Open on iOS Simulator (macOS only). To open the app in the Android emulator, first boot it up and then press Device and Open on Android.
Lastly, you will see a QR code inside the Share menu in XDE. For Android users, one fast way to open your project is simply to scan the QR code.

Open up screens/HomeScreen.js in your new project and change any of the text in the render() function. You should see your app reload with your changes.

Live reload is enabled by default, but let's just make sure we go over the steps to enable it in case somehow things just aren't working.
  • First, make sure you have development mode enabled in XDE.
  • Next, close the app and reopen it.
  • Once the app is open again, shake your device to reveal the developer menu. If you are using an emulator, press ⌘+d for iOS or ctrl+m for Android.
  • If you see Enable Live Reload, press it and your app will reload. If you see Disable Live Reload then exit the developer menu and try making another change.
    In-app developer menu

  • If you've followed the above steps and live reload still doesn't work, press the button in the bottom right of XDE to send us a support request. Until we resolve the issue for you, you can either shake the device and press Reload, or use one of the following tools which work both with an without development mode.
    Refresh using Expo buttons

You have created a new Expo project, made a change, and seen it update.

  • The Additional Resources has a bunch of useful resources for learning.
  • Read about the Expo SDK to learn about some useful APIs we provide out of the box.
  • Read some of our other guides, such as how to implement Push Notifications, how we can take care of Assets for you, or how to build Standalone Apps you can submit to Apple or Google.
  • Join us on Slack to get your questions answered.