android-notifications

name	android-notifications
description	Integrate Android app notifications using Firebase Cloud Messaging and NotificationCompat. Use when setting up FCM, notification channels, or client-side notification taps; defer Flutter, server sends, WorkManager orchestration, and generic Intent handling.
metadata	{"triggers":{"files":["**/*Notification*.kt","**/MainActivity.kt"],"keywords":["FirebaseMessaging","NotificationCompat","NotificationChannel","FCM"]}}

Android Notifications

Priority: P2 (MEDIUM)

Implementation Guidelines

• Channels: Create NotificationChannel with unique ID (required for API 26+). Notifications without valid channel silently dropped. Use NotificationCompat for backwards compatibility.
• Permissions: Explicitly request POST_NOTIFICATIONS on Android 13+ (API 33). Avoid requesting system permission on app launch; show priming dialog first to explain benefit.
• Service: Implement FirebaseMessagingService with onMessageReceived and onNewToken for background push handling. Declare service in AndroidManifest with MESSAGING_EVENT intent action.
• Flow: Handle notification taps in both onCreate and onNewIntent using PendingIntent. Pass data between activities via Intent extras.
• Payload: Limit notification payload to essential IDs. Perform background data fetching via WorkManager if more data needed.

Anti-Patterns

• No Missing Channel: Notifications fail silently without channels on API 26+.
• No Unconditional Requests: Don't spam permission dialog on first launch.
• No Missing Manifest: Service must declared with MESSAGING_EVENT action.

References

• Implementation Details