# 16. App Clips

meta:
  id: ios-production-16
  feature: ios-production
  priority: P3
  depends_on: []
  tags: [native-features, app-clips, production]

objective:
- Create an App Clip to allow users to preview Kordant functionality without downloading the full app

deliverables:
- App Clip target
- Lightweight onboarding flow
- Core feature preview (threat score check)
- App Clip invocation via QR code, NFC, or Safari

steps:
1. Create App Clip target:
   - Add App Clip target in Xcode (max 15MB)
   - Share code with main app where possible
   - Configure associated domains for invocation
2. Design App Clip experience:
   - Threat score check (no auth required, demo mode)
   - Basic spam number check
   - Signup prompt to unlock full features
   - Clear CTA to download full app
3. Implement lightweight UI:
   - Reuse SwiftUI components from main app
   - Remove features requiring auth
   - Simplify navigation (single screen or wizard)
   - Fast load time (<2 seconds)
4. Configure invocation:
   - Associated domain: appclips.kordant.com
   - QR code generation for marketing
   - Safari App Banner on website
   - NFC tag support (optional)
5. Add App Clip card:
   - Design card image (300x300 or 600x600)
   - Configure in App Store Connect
   - Include title, subtitle, action button
6. Handle App Clip to full app transition:
   - Preserve state when user installs full app
   - Transfer any entered data
   - Deep link to relevant screen after install

tests:
- Size: Verify App Clip <15MB
- Performance: Launch time <2 seconds
- Invocation: Test QR code and Safari banner

acceptance_criteria:
- App Clip target building and <15MB
- App Clip shows threat score demo without auth
- App Clip includes spam number check
- Clear CTA to download full app
- Invocation via QR code, Safari banner, and associated domains
- App Clip card configured in App Store Connect
- Smooth transition to full app with state preserved
- App Clip loads in <2 seconds
- Works on iOS 14+

validation:
- Scan QR code → App Clip launches
- Check threat score → demo data displayed
- Tap "Get Full App" → App Store opens
- Install full app → previous state preserved
- Check size → binary <15MB

notes:
- App Clips are optional but great for user acquisition
- 15MB limit is strict — may need to strip features
- Focus on one compelling use case (threat score)
- App Clips cannot use Apple Sign-In or in-app purchases