| 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. (triggers: **/*notification*.ts, **/*notification*.tsx, **/App.tsx, Notifications, messaging, FCM, expo-notifications, react-native-firebase) |
React Native Notifications
Priority: P1 (OPERATIONAL)
Push notifications using React Native Firebase or Expo Notifications.
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.
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.
