Notification Message Handler
Component Detail
Service Layer
high complexity
mobile
2
Dependencies
0
Dependents
1
Entities
0
Integrations
Description
Flutter-side handler for incoming FCM messages across all app lifecycle states - foreground, background, and terminated. Uses flutter_local_notifications to surface foreground alerts, routes background message taps to the correct screen via the typed action field, and updates Riverpod notification state on receipt.
notification-message-handler
Responsibilities
- Display local notification banners for foreground FCM messages using flutter_local_notifications
- Handle background messages via the firebase_messaging background isolate handler
- Parse the typed action field from notification payloads to drive deep-link routing on tap
- Update Riverpod unread notification count state on every inbound message
- Store received notification payloads in the local inbox for offline access
Interfaces
onForegroundMessage(RemoteMessage)
onBackgroundMessage(RemoteMessage)
onMessageOpenedApp(RemoteMessage)
handleNotificationTap(actionPayload)
initialize()
Relationships
Dependencies (2)
Components this component depends on