Back to Guides

App Store Deployment Guide

Configure automatic iOS app deployments to App Store Connect. Once set up, every successful build automatically uploads to TestFlight and can be submitted for App Store review.

Prerequisites

Before configuring App Store deployment, ensure you have:

  • Apple Developer Program Membership - Active membership ($99/year) with access to App Store Connect
  • App Created in App Store Connect - Your app must already exist in App Store Connect before connecting
  • App Store Connect API Key - With Admin role (required for uploading builds)
  • Team ID, Key ID, and Issuer ID - Available when creating the API key in App Store Connect

Step-by-Step Configuration

  1. 1

    Create App Store Connect API Key

    Navigate to App Store Connect → Users and Access → Integrations → App Store Connect API. Click the "+" button to create a new key.

    Name it (e.g., "ExpoDeploy"), select Admin access, and download the .p8 file immediately (you can only download it once).

  2. 2

    Note Your Credentials

    From the API Keys page, copy your Team ID, Key ID, and Issuer ID. You'll need all three values.

  3. 3

    Add Credentials to ExpoDeploy

    During onboarding or in project settings, paste your Team ID, Key ID, Issuer ID, and upload the .p8 file content. All credentials are encrypted and stored securely.

  4. 4

    Enable Automatic Deployments

    In your project settings, enable automatic deployments for the App Store. Configure which branches trigger deployments (typically "main" for production).

  5. 5

    Test Your First Deployment

    Push code to your configured branch. After the build completes, ExpoDeploy automatically uploads the IPA to App Store Connect. Check TestFlight to verify the upload.

How Automatic Deployment Works

When automatic deployment is enabled:

  • • Successful iOS builds automatically upload IPA files to App Store Connect
  • • Builds appear in TestFlight within minutes of upload completion
  • • You can configure automatic submission for review (optional)
  • • Builds are linked to your app version and build number
  • • You receive notifications when uploads complete or fail

After upload, you can test in TestFlight, submit for App Store review, or configure automatic submission in your project settings.

Troubleshooting

Common issues and solutions:

  • Upload fails: Verify API key has Admin role and all credentials are correct
  • App not found: Ensure your app exists in App Store Connect before connecting
  • Permission errors: Check that your API key hasn't been revoked in App Store Connect
  • Build not appearing: Wait a few minutes - App Store Connect processing can take 5-10 minutes