Athena — roomy-mobile/archive/changes/2026-01-05-implement-notifications/proposal.md

Change: Implement Push Notifications for Shopping List Activity

Why

Household members need to be notified when shopping list items are added or completed so they stay informed about household shopping activity without constantly checking the app.

What Changes

  • NEW Firebase Cloud Messaging (FCM) integration for push notifications (iOS + Android)
  • NEW Firestore notifications collection for in-app inbox storage
  • NEW Firestore notificationPreferences subcollection for per-user settings
  • NEW Cloud Function trigger for shopping list item create/complete events with 30-second batching
  • NEW Flutter notification handling service with deep linking support
  • NEW Notification preferences UI in settings (per-category toggles: Shopping, Cleaning, etc.)
  • MODIFIED Inbox feature to display and manage notifications with read/unread state
  • MODIFIED MessageType enum to include shopping notification types
  • EXTERNAL FCM configuration in Firebase Console (via Playwright automation)
  • EXTERNAL APNs certificate setup in Apple Developer Portal (via Playwright automation)

Impact

  • Affected specs: notifications (new), notification-preferences (new)
  • Affected code:
    • lib/inbox/ - Expand with notification service, API, and enhanced UI
    • lib/notifications/ - New feature module for FCM handling
    • lib/settings/ - Add notification preferences section
    • roomy-firebase/functions/src/notifications/ - New Cloud Functions for notification dispatch
    • Firebase Console configuration
    • Apple Developer Portal configuration
    • Android google-services.json / iOS GoogleService-Info.plist

Reacties

Nog geen reacties