apple-appstore-setup

Apple App Store Setup

Prerequisites

• Apple Developer Program membership ($99/year) at developer.apple.com
• Xcode installed (for Simulator; not required for EAS cloud builds)
• EAS CLI: npm install -g eas-cli && eas login

---

Step 1: Configure App Identifier

1. Go to developer.apple.com/account/resources/identifiers
2. Click + → App IDs → App
3. Fill in:
   • Description: Your app name
   • Bundle ID: Explicit — com.yourorg.appname (must match ios.bundleIdentifier in app.json)
4. Enable capabilities you need: Push Notifications, Sign in with Apple, Associated Domains (deep links)
5. Register

Bundle ID in app.json:

{
  "expo": {
    "ios": {
      "bundleIdentifier": "com.yourorg.appname"
    }
  }
}

---

Step 2: Create App Store Connect Listing

1. Go to appstoreconnect.apple.com
2. My Apps → + → New App
3. Fill in:
   • Platform: iOS
   • Name: Your app display name
   • Primary Language: English (or your language)
   • Bundle ID: Select the one you just registered
   • SKU: Unique internal identifier (e.g. com-yourorg-appname)
4. Create

Note the App ID (10-digit number) from the URL: appstoreconnect.apple.com/apps/XXXXXXXXXX — you need this for eas.json.

---

Step 3: Configure EAS Credentials

EAS manages certificates and provisioning profiles in the cloud. Run once per app:

cd mobile
eas credentials --platform ios

Select: production → Manage credentials → let EAS generate certificates automatically.

Then set up the App Store Connect API Key for submissions (required for eas submit to work):

eas credentials --platform ios

Select: production → App Store Connect: Manage your API Key → Set up your project to use an API Key for EAS Submit

Follow the prompts — EAS will ask for your Key ID, Issuer ID, and .p8 file. This is separate from build credentials and must be done before the first eas submit.