# 01. App Store Screenshots & Metadata

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

objective:
- Create and upload all required App Store screenshots and metadata for iOS app submission

deliverables:
- Screenshots for all required device sizes
- App metadata (name, subtitle, description, keywords)
- App Store listing content
- Promotional text and updates

steps:
1. Determine required screenshot sizes:
   - iPhone 6.7" (iPhone 14 Pro Max, 15 Pro Max): 1290x2796
   - iPhone 6.5" (iPhone 14 Plus, 13 Pro Max): 1284x2778
   - iPhone 5.5" (iPhone 8 Plus, SE 3rd gen): 1242x2208
   - iPad Pro 12.9" (6th gen): 2048x2732
   - iPad Pro 11" (4th gen): 1668x2388
2. Create screenshot content plan:
   - Screenshot 1: Dashboard with threat score and alerts
   - Screenshot 2: DarkWatch exposure list
   - Screenshot 3: VoicePrint enrollment screen
   - Screenshot 4: SpamShield call log/filtering
   - Screenshot 5: HomeTitle property monitoring
   - Screenshot 6: Settings and profile
   - Screenshot 7: Family plan management (if applicable)
   - Screenshot 8: Push notification example
3. Capture or generate screenshots:
   - Use iOS Simulator for precise sizing
   - Or use Screenshotting library for programmatic capture
   - Ensure status bar shows 9:41 and full battery
   - Use clean data (no real user info)
4. Write app metadata:
   - App Name: Kordant (30 chars max)
   - Subtitle: AI Identity Protection (30 chars max)
   - Description: 4000 chars highlighting features, benefits, use cases
   - Keywords: identity protection, dark web, spam blocker, voice clone, privacy (100 chars max)
   - Support URL, Marketing URL
   - Copyright info
5. Prepare App Store listing:
   - Primary category: Utilities or Lifestyle
   - Secondary category: Productivity or Security
   - Content rating: 4+ (no objectionable content)
   - Age rating questionnaire completed
6. Upload to App Store Connect:
   - Use Transporter app or Xcode upload
   - Verify all screenshot sizes present
   - Preview metadata in App Store Connect

tests:
- Visual: Review screenshots for quality and consistency
- Content: Verify no placeholder or test data visible
- Compliance: Check content rating accuracy

acceptance_criteria:
- Screenshots for all 5 required device sizes
- 5-8 screenshots per device size showing key features
- App metadata complete and within character limits
- Screenshots show real app UI with clean demo data
- Status bar shows 9:41 time and full battery
- No beta/test labels visible in screenshots
- Content rating accurate and complete
- All assets uploaded to App Store Connect

validation:
- App Store Connect → all screenshot slots filled
- Screenshots reviewed by designer → approved
- Metadata spell-checked and reviewed
- Content rating questionnaire submitted

notes:
- Use screenshot frames (iPhone bezel) for professional look
- Consider localized screenshots for major markets (EN, ES, FR)
- Screenshots are the #1 factor in app store conversion
- Update screenshots with each major UI release