1---
2name: expo-deployment
3description: Deploy Expo apps to production with EAS — build and submit to the iOS App Store, Google Play Store, and TestFlight, configure eas.json build and submit profiles, manage app versions and build numbers, publish App Store metadata and ASO, and deploy web bundles and API routes via EAS Hosting. Use whenever the user is preparing a production build, running eas build or eas submit, shipping to TestFlight, releasing or rolling out to the app stores, bumping version or build numbers, or setting up store listing metadata for an Expo app.
4version: 1.0.0
5license: MIT
6---
7 
8# Deployment
9 
10This skill covers deploying Expo applications across all platforms using EAS (Expo Application Services).
11 
12## References
13 
14Consult these resources as needed:
15 
16- ./references/workflows.md -- CI/CD workflows for automated deployments and PR previews
17- ./references/testflight.md -- Submitting iOS builds to TestFlight for beta testing
18- ./references/app-store-metadata.md -- Managing App Store metadata and ASO optimization
19- ./references/play-store.md -- Submitting Android builds to Google Play Store
20- ./references/ios-app-store.md -- iOS App Store submission and review process
21 
22## Quick Start
23 
24### Install EAS CLI
25 
26```bash
27npm install -g eas-cli
28eas login
29```
30 
31### Initialize EAS
32 
33```bash
34npx eas-cli@latest init
35```
36 
37This creates `eas.json` with build profiles.
38 
39## Build Commands
40 
41### Production Builds
42 
43```bash
44# iOS App Store build
45npx eas-cli@latest build -p ios --profile production
46 
47# Android Play Store build
48npx eas-cli@latest build -p android --profile production
49 
50# Both platforms
51npx eas-cli@latest build --profile production
52```
53 
54### Submit to Stores
55 
56```bash
57# iOS: Build and submit to App Store Connect
58npx eas-cli@latest build -p ios --profile production --submit
59 
60# Android: Build and submit to Play Store
61npx eas-cli@latest build -p android --profile production --submit
62 
63# Shortcut for iOS TestFlight
64npx testflight
65```
66 
67## Web Deployment
68 
69Deploy web apps using EAS Hosting:
70 
71```bash
72# Deploy to production
73npx expo export -p web
74npx eas-cli@latest deploy --prod
75 
76# Deploy PR preview
77npx eas-cli@latest deploy
78```
79 
80Expo Router API routes deploy together with the web bundle on EAS Hosting — `eas deploy` ships both. To author or configure the API routes themselves, use the `expo-api-routes` skill.
81 
82## EAS Configuration
83 
84Standard `eas.json` for production deployments:
85 
86```json
87{
88  "cli": {
89    "version": ">= 16.0.1",
90    "appVersionSource": "remote"
91  },
92  "build": {
93    "production": {
94      "autoIncrement": true,
95      "ios": {
96        "resourceClass": "m-medium"
97      }
98    },
99    "development": {
100      "developmentClient": true,
101      "distribution": "internal"
102    }
103  },
104  "submit": {
105    "production": {
106      "ios": {
107        "appleId": "[email protected]",
108        "ascAppId": "1234567890"
109      },
110      "android": {
111        "serviceAccountKeyPath": "./google-service-account.json",
112        "track": "internal"
113      }
114    }
115  }
116}
117```
118 
119## Platform-Specific Guides
120 
121### iOS
122 
123- Use `npx testflight` for quick TestFlight submissions
124- Configure Apple credentials via `eas credentials`
125- See ./references/testflight.md for credential setup
126- See ./references/ios-app-store.md for App Store submission
127 
128### Android
129 
130- Set up Google Play Console service account
131- Configure tracks: internal → closed → open → production
132- See ./references/play-store.md for detailed setup
133 
134### Web
135 
136- EAS Hosting provides preview URLs for PRs
137- Production deploys to your custom domain
138- See ./references/workflows.md for CI/CD automation
139 
140## Automated Deployments
141 
142EAS Workflows automate the build → submit → update → deploy pipeline for CI/CD. See ./references/workflows.md for deployment-oriented examples. To author or validate workflow YAML, use the `expo-cicd-workflows` skill — it works from the live workflow schema.
143 
144## Version Management
145 
146EAS manages version numbers automatically with `appVersionSource: "remote"`:
147 
148```bash
149# Check current versions
150eas build:version:get
151 
152# Manually set version
153eas build:version:set -p ios --build-number 42
154```
155 
156## Monitoring
157 
158```bash
159# List recent builds
160eas build:list
161 
162# Check build status
163eas build:view
164 
165# View submission status
166eas submit:list
167```
168