After your handoff
Launch guide.
From your handoff zip to TestFlight and the App Store — in plain language. Rewrite gave you native iOS source and artifacts for the scope you approved. Shipping on the App Store happens on your Mac and your Apple developer account — certificates, listings, and review are yours to run. This guide is engineering orientation, not legal or compliance advice; get professional help for regulated products (health, payments, kids, etc.).
1
Get a build you trust in Xcode
- ●Open your project in Xcode on a Mac and resolve any remaining wiring (API base URL, OAuth, polish).
- ●Run on Simulator, then on a physical device — device builds catch signing and entitlement issues early.
- ●Confirm Bundle ID is what you want long-term — changing it later is painful.
- ●Set Version (user-facing) and Build (must increase for every upload to Apple).
2
Signing (Apple Developer Program)
- ●Enroll in the Apple Developer Program if you haven't ($99/year at time of writing).
- ●In Xcode: Project → Signing & Capabilities → pick your Team, set Bundle Identifier to match App Store Connect.
- ●Prefer Automatically manage signing unless your org uses manual profiles.
- ●Enable only capabilities you need (Push, Associated Domains, etc.) — each can require extra portal setup.
3
Create an archive and upload
- ●Select Any iOS Device (arm64) or a connected iPhone — not Simulator-only — as the run destination.
- ●Product → Archive. When the Organizer opens, Distribute App → App Store Connect (for TestFlight / App Store).
- ●If upload fails, common fixes: bump build number, refresh signing in Xcode Accounts, fix version conflicts in App Store Connect.
4
App Store Connect — app record and compliance
- ●In App Store Connect, create the app if needed; Bundle ID must match Xcode exactly.
- ●Complete App Privacy (data collection) truthfully — it feeds the App Store nutrition labels.
- ●Plan screenshots and description for the device sizes you support; Apple requires assets per size class you claim.
5
TestFlight (beta)
- ●After upload processing completes, the build appears under TestFlight.
- ●Answer export compliance / encryption questions when prompted (many apps use standard exemptions; read Apple's questionnaire carefully).
- ●Internal testers (your team) can install quickly. External testers may need Beta App Review for the first build of a version.
- ●Install Apple's TestFlight app on devices, accept invites, install builds.
6
Submit to the App Store
- ●When you're ready for production, create a version in App Store Connect, attach the build, and complete required metadata.
- ●Submit for review. Apple's App Review Guidelines apply — allow time for feedback and resubmits.
When something fails
| Symptom | What to check |
|---|---|
| Signing errors | Team, Bundle ID, cert expiry — Xcode Settings → Accounts to refresh. |
| Upload rejected | Build number already used; bump build and archive again. |
| Processing stuck | Wait; if it fails, read the email from Apple for the specific binary issue. |
| Compliance prompts | Finish encryption / export questions in App Store Connect. |
Deeper reference
- Bundled in every handoff zip as
APP_STORE_GUIDE.md(this same content) andREADME.md(condensed Xcode + signing intro). - Apple: App Store Connect Help · Review Guidelines · Distributing your app for beta testing and releases
- Open-source repo: docs/app-store-after-handoff.md (markdown source).
Rewrite supplies code and handoff artifacts; your team owns Apple accounts, signing, store listing, and compliance.