Kordant/tasks/ios-production/16-app-clips.md

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