This guide walks you through the process of using Despia's native App Store Connect integration to publish your iOS application to the Apple App Store.
Overview
Despia offers a one-click publishing solution that simplifies the entire CI/CD/deployment pipeline for iOS applications. With our native App Store Connect integration, you can:
-
Test your application internally via TestFlight
-
Distribute beta versions to testers through public TestFlight beta groups
-
Publish your app to the Apple App Store to reach millions of users
When you publish with Despia, your application is initially sent as a draft to TestFlight for testing before you submit it for App Store review.
Before you begin, ensure you have:
-
An Apple Developer account
-
Access to App Store Connect (appstoreconnect.apple.com)
-
Access to the Apple Developer portal (developer.apple.com)
-
Logged into both sites with the same Apple Developer account
Connect Your Apple Developer Account
-
In Despia, click on Publish App (or Device Testing)
-
In the one-click deployment widget, click on the Development Team dropdown
-
If you don't have an account linked, click Add New Developer Account
-
Find your Development Team ID:
-
Go to developer.apple.com
-
Navigate to any section (e.g., Identifiers)
-
Your Team ID appears in the top right corner next to your company name
-
Copy and paste this ID into Despia
-
-
Find your Account Issuer ID:
-
Go to App Store Connect (appstoreconnect.apple.com)
-
Navigate to Users and Access > Integrations
-
Copy the Issuer ID under Team Keys
-
Paste it into Despia
-
-
Create an API Key:
-
In App Store Connect, go to Users and Access > Integrations
-
Click the + button to create a new API key
-
Name it "Despia"
-
Grant it App Manager access
-
Click Generate
-
Download the API key file (back it up, as you can only download it once)
-
Upload this file to Despia
-
Copy the Key ID and paste it into Despia
-
-
Click Link with Apple to complete the connection
Register Your App in App Store Connect
-
Go to App Store Connect > Apps
-
Click + New App
-
Select iOS platform
-
Create a Bundle ID:
-
Click on "Certificates, Identifiers, and Profiles" link
-
In the Apple Developer portal, select Identifiers
-
Click + to add a new identifier
-
Select App IDs, then click Continue
-
Name your app (e.g., "Lux Stay")
-
Use Explicit Bundle ID
-
Copy your bundle ID from Despia and paste it here
-
-
Configure App Capabilities (minimum requirements):
-
App Attest
-
App Groups
-
Associated Domains (helpful for deep linking)
-
Push Notifications
-
Push Notifications > Broadcast capability
-
Other capabilities as needed for your app's features
-
Click Register
-
-
Create an App Group:
-
In the Apple Developer portal, go to Identifiers
-
Click + to add a new identifier
-
Select App Groups, then Continue
-
Name it (e.g., "App Group for Lux Stay")
-
Copy the group ID from Despia and paste it here
-
Click Register
-
-
Link the App Group to your Bundle ID:
-
Go back to App IDs in Identifiers
-
Find and select your app's bundle ID
-
Click on the App Groups capability where it says "Configure"
-
Check the app group you just created
-
Click Continue, then Save
-
-
Return to App Store Connect:
-
Reload the page if necessary
-
Click + New App again
-
Select iOS
-
Enter your app name
-
Select your bundle ID
-
Add a SKU (typically your app name in caps)
-
Set access permissions
-
Click Create
-
-
Copy the Apple ID (App ID):
-
In App Store Connect, go to App Information
-
Copy the Apple ID (numeric identifier)
-
Paste it into Despia's App Store App ID field
-
Set Up TestFlight for Beta Testing
-
In App Store Connect, go to TestFlight
-
Create an Internal Testing group:
-
Click Internal Testing
-
Name your group (e.g., "Despia Testers")
-
Enable automatic distribution if desired
-
Click Create
-
Add testers by email
-
-
For public beta testing (optional):
-
Go to External Testing
-
Click + to create a new group
-
Name it (e.g., "Public Beta")
-
Click Create
-
Add the build you want to test
-
Fill out required information
-
Submit for review
-
Publish Your App
-
In Despia, click Publish Project
-
Wait for the build process to complete:
-
Despia will gather your project files
-
Build your application on Apple Silicon hardware
-
Sign and distribute it to App Store Connect
-
This can take 30-60 minutes depending on queue
-
-
After successful submission:
-
You'll receive an email notification
-
The build will appear in App Store Connect
-
You may need to answer compliance questions (e.g., encryption usage)
-
-
Test your app:
-
Install TestFlight on your iOS device
-
Open the invitation email
-
Install and test your application
-
Any updates you make in Despia will be available after refreshing the app
-
Submit to the App Store
-
In App Store Connect, go from TestFlight to App Store
-
Complete all required information:
-
Upload screenshots for all device sizes
-
Add app description, promotional text, keywords
-
Add privacy policy
-
Fill out content rights information
-
-
Add your build:
-
Click Add Build
-
Select the build from TestFlight
-
Complete any remaining requirements
-
Click Submit for Review
-
-
Wait for Apple's review process (typically up to one week)
Common Rejection Reasons and Solutions
UI/UX Issues
-
Missing mobile menu bar: Apple requires a proper mobile navigation UI
-
External links opening in Safari: Use in-app tabs for better user experience
Payment Issues
-
In-app purchases: Required for digital goods, premium features, subscriptions
-
When to use IAP: Required for credits, tokens, ad-free experiences, app currency
-
When IAP is not required: Physical products, services with external value (like marketplace leads)
App Functionality
-
Web page as app: Apps should leverage native features (push notifications, haptic feedback)
-
Apps running user-generated code: May require disclaimers or special approval
Getting Help
If you encounter any issues during the publishing process:
-
For existing bundle IDs you want to import, contact us at support@despia.com
-
For app store rejections, contact us at support@despia.com for guidance on resolving issues
-
For implementation help with in-app purchases or other features, use contact us at support@despia.com.
Note: This process allows you to deploy your Despia iOS application with over-the-air updates. Once your app is on TestFlight, any changes made in Despia will be available after simply refreshing the app.