NOTE: macOS is required to build standalone iOS apps.
This guide describes an advanced feature of Expo. In most cases you can build
standalone Expo apps using Expo's build services as described in the guide
on Building Standalone Apps.
If you prefer to not rely on our builders stability and you don't like waiting
in the queue to get your standalone app build then you can build your Expo
project on your own. The only thing you need is Turtle CLI. Turtle CLI is
a command line interface for building Expo standalone apps. You can use it
both on your CI and your private computer.
Then run turtle setup:ios and/or turtle setup:android to verify everything
is installed correctly. This step is optional and is also performed during
the first run of the Turtle CLI. Please note that the Android setup command
downloads, installs, and configures the appropriate versions of the Android SDK
If you would like to make the first build even faster, you can supply the Expo
SDK version to the setup command like so: turtle setup:ios --sdk-version 30.0.0.
This tells Turtle CLI to download additional Expo-related dependencies for
the given SDK version.
All Expo-related dependencies will be installed in a directory named .turtle
within your home directory. This directory may be removed safely if you ever
need to free up some disk space.
If you choose to publish your app to Expo servers, you must have an Expo
developer account and supply your credentials to the turtle-cli.
The recommended approach is to define two environment variables called
EXPO_USERNAME and EXPO_PASSWORD with your credentials, though you may also
pass these values to the build command from the command line. We recommending
using the environment variables to help keep your credentials out of your
terminal history or CI logs.
Building for Android
Before starting the build, prepare the following things: