Skip to main content
This guide walks you through submitting your Bilt app to the Apple App Store — from enrolling in the Apple Developer Program to your first TestFlight build. Open Settings → App Store in your project to follow along.

​
Prerequisites

​
Step 1: Enroll in the Apple Developer Program

If you are not enrolled yet:
  1. Go to developer.apple.com/programs/enroll
  2. Enroll as an individual or organization
  3. Complete identity verification (may take 24–48 hours)

​
Step 2: Create your app and bundle ID

Register the bundle ID in Apple’s developer portal, create the app in App Store Connect, then link both in Bilt.
1

Register a Bundle ID

  1. Go to Apple Developer Portal — Register a Bundle ID
  2. Enter your bundle identifier (e.g. com.yourcompany.appname) and a description
  3. Click Continue and complete the registration
2

Create the app in App Store Connect

  1. Go to App Store Connect — Apps
  2. Click + next to Apps in the top left corner and select New App
  3. Select iOS as the platform, enter your app name, and choose a primary language
  4. For Bundle ID, select the bundle ID you registered in the previous step
  5. For SKU, enter any unique value (for example, the last segment of your bundle ID)
  6. Set User Access to Full Access, then click Create
3

Link both in Bilt

In your Bilt project, open Settings → App Store → App Store Connect:
  1. Under Bundle ID, enter the bundle identifier you registered and click Save
  2. Find your Apple ID in App Store Connect:
    • Open App Store Connect — Apps
    • Click the app you created
    • In the left sidebar, click General → App Information
    • On the App Information page, look under the General Information heading for Apple ID — a numeric value such as 1234567890 (this is not your bundle ID)
    • Copy that number
  3. Under App ID, paste the Apple ID into the field

​
Step 3: Create an App Store Connect API key

Bilt uses your API key to create and manage signing assets on your behalf. Generate the key in App Store Connect, then add it in the App Store Connect tab.
1

Open App Store Connect API keys

Go to App Store Connect → Integrations → App Store Connect API
2

Generate a new key

Under Team Keys, click + next to Active. Name the key (e.g. “Bilt”), set the role to Admin, and click Generate
3

Download and copy credentials

Mark down the Issuer ID and Key ID, then download the .p8 private key file.
The .p8 file can only be downloaded once. Store it securely.
4

Link in Bilt

In your project, open Settings → App Store → App Store Connect, scroll to API Key, and click Configure API key:
  1. Enter your Issuer ID
  2. Enter your Key ID
  3. Upload your Private key (.p8) file
  4. Click Save

​
Step 4: Set up certificates and provisioning profiles

Open Settings → App Store → Certificates:
  • Generate — Bilt creates a distribution certificate and provisioning profile for you (recommended if you do not already have signing assets)
  • Upload your own — Provide an existing .p12 certificate and .mobileprovision profile if you already use Apple distribution signing
Extension targets (widgets, etc.) can be configured in the same tab when your app needs them.

​
Step 5: Build and publish to TestFlight

Open Settings → App Store → Publish:
  1. Click Start build & publish when all prior steps are complete
  2. Bilt runs a cloud build. Progress appears under Recent builds
  3. After the build finishes and Apple processes it, open TestFlight from the Publish tab to manage testers
The Quickstart tab shows which steps are done and links you to the tab that still needs attention.

​
Step 6: Submit for App Store review

When you are ready to go live:
  1. Complete your App Store listing in App Store Connect (description, screenshots, pricing)
  2. Select your build in Testflight and submit for review
  3. Apple reviews the app
  4. Once approved, your app is live on the App Store

​
App Store tabs in Bilt

TabWhat to configure
QuickstartGuided checklist through all steps above
App Store ConnectBundle ID, App ID, and API key (.p8, Key ID, Issuer ID)
CertificatesGenerate or upload distribution certificate and provisioning profile
PublishStart builds, monitor progress, and open TestFlight

​
Common issues

You have hit Apple’s limit for distribution certificates on your account. Revoke an unused certificate in the Apple Developer certificates list, then try generating again in the Certificates tab.
If you see A target with this bundle id is already declared on the project, that bundle identifier is already linked to this Bilt project (for the main app or an extension). Use the existing target in the Certificates tab, or choose a different bundle ID when registering a new one in Apple Developer.
Ensure your distribution certificate matches the provisioning profile, and both match the bundle ID. Regenerate in the Certificates tab or upload matching assets.
Check the build logs in the Publish tab. Common causes: expired certificate, missing app icon, or unsupported API usage.
Apple provides a reason for rejection. Common fixes: add a privacy policy URL, ensure the app has enough functionality, and remove placeholder content.

​
Further reading