get to prod tasks

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

@@ -0,0 +1,75 @@
+# 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