# Expo

Expo's EAS service creates each app's project and builds it for iPhone and Android. You use **your own** Expo account.

**Time:** about 5 minutes. **Needs:** an Expo account. Create it yourself at <https://expo.dev>.

## Steps

1. Sign in at <https://expo.dev> to the account or organization that will own your apps.
2. Go to **Account settings → Access tokens** (for an organization: **Organization settings → Access tokens**; a robot user with the **Developer** role is best).
3. Click **Create token**, name it `starwisp`, and copy it. It is shown once.
4. Put the owner's username in **Settings → Identity → Expo account**.

**Least privilege:** prefer an organization robot user with the Developer role over your personal account's token.

## Where it goes

Console → **Settings → Vault** → card **Expo access token** → field **Access token** (secret `EXPO_TOKEN`). Click **Test now**.

**You should now see** a passing test on the card.

## What it gates

Creating each app's Expo project (the **spawn** step) and building and submitting apps (**ship**). Both presets need it for the spawn step.

## What it costs

Free plan: about 15 iOS and 15 Android builds a month, a slower queue, and a build time limit. Starter is $19 a month plus usage if you need more. Treat these as estimates and check <https://expo.dev/pricing>. Each iOS build is booked at an estimated $2 against your Starwisp budget.

## Slow prerequisites

None for the Expo account itself. iOS builds need an Apple Developer account (see [Apple](apple.md)); Android builds do not need one to create a preview APK.

## Common problems

If builds queue for a long time, that is the free plan's low-priority queue. If you reach the monthly build limit, builds wait or fail until it resets or you upgrade.
