version: "1.0.1" name: react-native-notifications description: Push notifications for React Native using Firebase or Expo Notifications. Use when integrating push notifications with Firebase or Expo in React Native. metadata: triggers: files:

• '**/notification.ts'
• '**/notification.tsx'
• '**/App.tsx'

keywords:

• Notifications
• messaging
• FCM
• expo-notifications
• react-native-firebase

React Native Notifications

Priority: P1 (HIGH)

Guidelines

• Library: Choose @react-native-firebase/messaging (Bare) or expo-notifications (Managed).
• Setup: Configure Platform channels (Android) and APNs (iOS).
• Lifecycle: Handle Foreground (onMessage), Background (onNotificationOpenedApp), and Quit (getInitialNotification) states.
• Permissions: Prime users before requesting system authorization.

See implementation examples for complete FCM handler setup with permission request and lifecycle handlers.

Anti-Patterns

• No Unconditional Requests: Spamming permission dialogs leads to high denial rates.
• No Missing Handlers: Forgetting "Quit" state handling results in lost deep links.
• No Unvalidated Data: Blindly trusting payload data causes runtime crashes.

References

See references/implementation.md for FCM setup, APNs config, and lifecycle handlers.