Kordant/tasks/ios-production/03-app-store-connect.md

03. App Store Connect Configuration

meta: id: ios-production-03 feature: ios-production priority: P1 depends_on: [] tags: [app-store, configuration, production]

objective:

• Complete all App Store Connect configuration for app submission and distribution

deliverables:

• App record created in App Store Connect
• Bundle ID registered and configured
• Signing certificates and provisioning profiles
• App Review information
• Pricing and availability

steps:

1. Create App Store Connect record:
   • App name: Kordant
   • Primary language: English
   • Bundle ID: com.kordant.app (or existing)
   • SKU: kordant-001
   • User Access: Full access for team
2. Configure app capabilities:
   • Push Notifications (entitlements configured)
   • Background Modes (fetch, remote notifications)
   • Camera (for document scanning)
   • Microphone (for VoicePrint enrollment)
   • Face ID / Touch ID (biometric auth)
   • Associated Domains (universal links)
3. Set up signing:
   • Apple Developer account ($99/year)
   • Create Distribution certificate
   • Create App Store provisioning profile
   • Configure Xcode with correct team and signing
4. Configure pricing:
   • Price tier: Free (subscription handled in-app or via web)
   • If in-app purchases: configure in App Store Connect
   • Subscription groups and tiers
   • Introductory offers (free trial)
5. Set availability:
   • All countries or selected markets
   • Pre-order option (optional)
   • Release strategy (manual or automatic)
6. Prepare App Review info:
   • Contact information
   • Demo account credentials (username/password for testing)
   • Notes for reviewer (explain app functionality)
   • Attachment: privacy policy, terms of service
7. Configure TestFlight:
   • Internal testers (team members)
   • External testers (beta group)
   • Test information and feedback email

tests:

• Build: Archive and validate app in Xcode
• Upload: Upload build to App Store Connect
• Verification: Confirm build appears in TestFlight

acceptance_criteria:

• App record created in App Store Connect
• Bundle ID registered and matches Xcode project
• Distribution certificate and provisioning profile active
• All required capabilities enabled
• Pricing set (free with subscriptions)
• Availability configured for target markets
• App Review information complete with demo account
• TestFlight configured with internal testers
• Build successfully uploaded and processing

validation:

• Xcode → Product → Archive → Validate → no errors
• Upload build → appears in App Store Connect within 30 minutes
• TestFlight → build available for internal testing
• App Review info → all fields complete

notes:

• Ensure Apple Developer membership is active and paid
• Bundle ID must match exactly across all configs
• Demo account is critical for reviewer testing
• TestFlight builds must be signed with Distribution cert