React Native Push Notifications: Permissions First

Why it exists

Mobile operating systems have their own native, proprietary systems for push notifications. Building and maintaining separate logic for both iOS and Android is complex. Firebase Cloud Messaging (FCM) provides a single, free, cross-platform service to send messages from a server to devices, and the react-native-firebase/messaging module bridges this service into your JavaScript code.

The mental model

Think of push notifications as your app's mailbox. Your server drops a letter (a message payload) into the FCM service. FCM, the postal worker, delivers it to the correct device's operating system. Your React Native app, however, must first ask the user for the key to that mailbox—explicit permission—before the OS will allow it to read or display the letter.

How it works

After installing the @react-native-firebase/messaging module, the primary task is handling permissions. On iOS, you must call messaging().requestPermission() to trigger the native dialog asking for the user's consent. The function returns an authorization status; your app will only display notifications if the status is AUTHORIZED or PROVISIONAL. On Android, permissions are generally granted by default. Platform-specific configuration is also required. For iOS, this includes setting the aps-environment entitlement. For modern Android, the library automatically disables 'Notification Delegation' to ensure your JavaScript listeners are reliably triggered, working around a potential incompatibility.

When to use it

Use push notifications for asynchronous, server-driven communication. It's ideal for alerting users about events that happen when they might not have the app open, such as new chat messages, order status updates, or breaking news.

When not to use it

Avoid using push notifications for data that is critical for the app's immediate, in-focus state. For real-time updates while the user is actively using the app, a WebSocket or other direct data-fetching mechanism is more appropriate and reliable. Push notifications are for out-of-band alerts, not for core state management.

One canonical example

To handle the most common footgun, you must request permission on iOS. The code looks like this: import messaging from '@react-native-firebase/messaging'; async function requestUserPermission() { const authStatus = await messaging().requestPermission(); const enabled = authStatus === messaging.AuthorizationStatus.AUTHORIZED || authStatus === messaging.AuthorizationStatus.PROVISIONAL; if (enabled) { console.log('Authorization status:', authStatus); } }