--- name: expo-deployment description: "Deploy Expo apps with EAS: build and submit iOS and Android releases, configure build and submit profiles, manage versions and store metadata, and deploy web bundles or API routes." risk: critical source: https://github.com/expo/skills/tree/main/plugins/expo/skills/expo-deployment source_repo: expo/skills source_type: official date_added: 2026-07-01 license: MIT license_source: https://github.com/expo/skills/blob/main/LICENSE --- # Deployment ## When to Use Use this skill when you need 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... This skill covers deploying Expo applications across all platforms using EAS (Expo Application Services). ## References Consult these resources as needed: - ./references/workflows.md -- CI/CD workflows for automated deployments and PR previews - ./references/testflight.md -- Submitting iOS builds to TestFlight for beta testing - ./references/app-store-metadata.md -- Managing App Store metadata and ASO optimization - ./references/play-store.md -- Submitting Android builds to Google Play Store - ./references/ios-app-store.md -- iOS App Store submission and review process Before cloud builds, submissions, metadata pushes or deployments, confirm the exact project/account, artifact, track/channel and cost. Prepare configuration first; publishing requires the user’s authorized scope. Pin a reviewed CLI version for automation rather than floating @latest. ## Quick Start ### Install EAS CLI ```bash npm install -g eas-cli eas login ``` ### Initialize EAS ```bash npx eas-cli@latest init ``` `eas init` links/creates the EAS project. Run `eas build:configure` to configure build profiles and review the resulting eas.json. ## Build Commands ### Production Builds ```bash # iOS App Store build npx eas-cli@latest build -p ios --profile production # Android Play Store build npx eas-cli@latest build -p android --profile production # Both platforms npx eas-cli@latest build --profile production ``` ### Submit to Stores ```bash # iOS: Build and submit to App Store Connect npx eas-cli@latest build -p ios --profile production --auto-submit # Android: Build and submit to Play Store npx eas-cli@latest build -p android --profile production --auto-submit # Shortcut for iOS TestFlight eas build -p ios --profile production --auto-submit ``` ## Web Deployment Deploy web apps using EAS Hosting: ```bash # Deploy to production npx expo export -p web npx eas-cli@latest deploy --prod # Deploy PR preview npx eas-cli@latest deploy ``` Expo 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. ## EAS Configuration Standard `eas.json` for production deployments: ```json { "cli": { "version": ">= 16.0.1", "appVersionSource": "remote" }, "build": { "production": { "autoIncrement": true, "ios": { "resourceClass": "m-medium" } }, "development": { "developmentClient": true, "distribution": "internal" } }, "submit": { "production": { "ios": { "appleId": "your@email.com", "ascAppId": "1234567890" }, "android": { "serviceAccountKeyPath": "./google-service-account.json", "track": "internal" } } } } ``` ## Platform-Specific Guides ### iOS - Use `eas build -p ios --profile production --auto-submit` for quick TestFlight submissions - Configure Apple credentials via `eas credentials` - See ./references/testflight.md for credential setup - See ./references/ios-app-store.md for App Store submission ### Android - Set up Google Play Console service account - Configure tracks: internal → closed → open → production - See ./references/play-store.md for detailed setup ### Web - EAS Hosting provides preview URLs for PRs - Production deploys to your custom domain - See ./references/workflows.md for CI/CD automation ## Automated Deployments EAS 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. ## Version Management EAS manages version numbers automatically with `appVersionSource: "remote"`: ```bash # Check current versions eas build:version:get # Manually set version eas build:version:set -p ios # interactive; verify selected project/value ``` ## Monitoring ```bash # List recent builds eas build:list # Check build status eas build:view # View submission status # Inspect the exact submission in the EAS project dashboard ``` ## Limitations - Use this skill only when the task clearly matches its upstream product or API scope. - Verify commands, API behavior, pricing, quotas, credentials, and deployment effects against current official documentation before making changes. - Do not treat generated examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions. --- Source attribution: expo/skills contributors, via Agentic Awesome Skills Original project: https://github.com/expo/skills License: MIT + CC-BY-4.0 License information: https://creativecommons.org/licenses/by/4.0/ Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice The MIT License (MIT) Copyright (c) 2025-present 650 Industries, Inc. (aka Expo) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: expo/skills contributors, via Agentic Awesome Skills Original project: https://github.com/expo/skills Attribution basis: Recorded upstream repository Fields of work: Development & Engineering Roles: DevOps / SRE Specialties: Specialty not specified Tools: Tool not specified Country applicability: Country not specified Classification basis: Dave AI task classification from package title, description, and declared metadata Instruction SHA-256: cd7add20d74d598b632d740b5136f3a99b7cfe8e439dc404bd773d0d8e91614a Metadata reviewed: 2026-10-27 This metadata supersedes earlier Mega AI Hub catalog attribution. Original instruction and supporting files are preserved.