get to prod tasks

tasks/android-production/15-shortcuts-widgets.md

@@ -0,0 +1,84 @@
+# 15. App Shortcuts & Widgets
+
+meta:
+  id: android-production-15
+  feature: android-production
+  priority: P2
+  depends_on: []
+  tags: [native-features, widgets, production]
+
+objective:
+- Implement app shortcuts and home screen widgets to improve user engagement and accessibility
+
+deliverables:
+- Dynamic and static app shortcuts
+- Home screen widget (threat score)
+- Widget configuration
+- Shortcut deep linking
+
+steps:
+1. Implement app shortcuts:
+   - Static shortcuts in shortcuts.xml:
+     - "View Dashboard" → opens dashboard
+     - "Check Alerts" → opens alerts
+     - "Run Scan" → starts DarkWatch scan
+   - Dynamic shortcuts:
+     - "Recent Alert" → opens latest alert
+     - "Quick Check" → runs quick threat assessment
+2. Create home screen widget:
+   - GlanceAppWidget for modern Compose widgets
+   - Or traditional AppWidgetProvider
+   - Sizes: 2x1 (threat score), 3x2 (score + alerts)
+   - Update every 30 minutes (widget limit)
+3. Design widget UI:
+   - Match app design system
+   - Show threat score with color coding
+   - Show number of unread alerts
+   - Show last update time
+   - Support dark/light themes
+4. Implement widget updates:
+   - Update on app data refresh
+   - Schedule periodic updates
+   - Handle widget configuration changes
+5. Add deep linking:
+   - Tap widget → open dashboard
+   - Tap alert count → open alerts list
+   - Tap threat score → open dashboard
+6. Add preview:
+   - Widget preview image for picker
+   - Description for accessibility
+7. Test:
+   - Add widget to home screen
+   - Verify updates work
+   - Test shortcuts
+
+tests:
+- Unit: Test widget provider
+- Integration: Test shortcut deep links
+- UI: Test widget rendering
+
+acceptance_criteria:
+- 3+ app shortcuts defined
+- Static shortcuts working
+- Dynamic shortcuts updated based on user activity
+- Home screen widget showing threat score
+- Widget updates every 30 minutes
+- Widget supports dark and light themes
+- Deep links from shortcuts and widgets work
+- Widget preview in picker
+- No crashes when widget data missing
+- Widgets work on Android 8+ (API 26+)
+
+validation:
+- Long press app icon → shortcuts visible
+- Tap shortcut → correct screen opens
+- Add widget to home screen → threat score displayed
+- Receive new alert → widget updates
+- Tap widget → dashboard opens
+- Check widget in dark mode → colors correct
+
+notes:
+- App shortcuts are great for power users
+- Widgets use RemoteViews (limited UI capabilities)
+- Glance is modern but requires additional dependency
+- Test on different launchers (Pixel, Samsung, Nova)