How to set up Firebase Cloud Messaging with React Native push notifications?

Follow the library's Android guide: add Google Services plugin and dependencies in build.gradle, configure AndroidManifest.xml with receivers, and place google-services.json in the app folder. Use onRegister to handle tokens.

Why are my scheduled notifications not showing on Android?

Ensure you've added the RECEIVE_BOOT_COMPLETED permission and RNPushNotificationPublisher receiver in AndroidManifest.xml, and that the channelId is correctly set when creating notifications, as channels are required for Android Oreo and above.

React Native push notifications vs Notifee: which is better?

Notifee is actively maintained and offers more modern features like foreground service support, while this library is legacy but has extensive documentation. For new projects, Notifee is recommended due to better reliability and updates.

How to add interactive buttons to notifications in React Native?

Use the actions property in notification configuration, handle clicks in the onAction callback, and for Android, ensure the RNPushNotificationActions receiver is in the manifest. For iOS, set categories using setNotificationCategories.

Can I use custom notification sounds in both iOS and Android?

Yes, add sound files to android/app/src/main/res/raw for Android and Xcode Resources for iOS, then specify the soundName in notification details. The library supports common audio formats.

How to test push notifications in a React Native iOS simulator?

Use the PushNotificationIOS library's simulation methods or test with physical devices, as simulators have limitations. For remote notifications, tools like Firebase console or APNs certificates are needed.

Open-Awesome

react-native-push-notification

MITJava8.1.1

A React Native library for handling local and remote push notifications on iOS and Android.

GitHub

6.8k stars2.0k forks0 contributors

What is react-native-push-notification?

React Native Push Notifications is a library that enables React Native apps to send and receive local and remote push notifications on iOS and Android. It solves the problem of implementing platform-specific notification systems by providing a unified JavaScript API for scheduling notifications, handling user interactions, and managing permissions.

Target Audience

React Native developers building mobile applications that require user engagement through notifications, such as messaging apps, task managers, or event reminders.

Value Proposition

Developers choose this library for its comprehensive feature set covering both local and remote notifications, extensive customization options, and detailed documentation for complex use cases like notification channels and scheduled repeats.

Overview

React Native Local and Remote Notifications

Use Cases

Best For

Adding push notification support to a React Native app
Scheduling local reminders or alarms in a mobile app
Implementing notification channels for Android Oreo and above
Handling interactive notification actions (e.g., buttons, replies)
Managing app icon badge counts across iOS and Android
Integrating with Firebase Cloud Messaging for remote notifications

Not Ideal For

Projects requiring active maintenance and support for the latest iOS/Android notification APIs
Teams wanting a zero-configuration or drop-in solution without manual native code edits
Applications where notification delivery reliability is critical, given the library's complexity and inactive status

Pros & Cons

Pros

Unified Cross-Platform API

Abstracts iOS and Android notification complexities into a single JavaScript interface, simplifying permission handling, scheduling, and user interactions across platforms.

Comprehensive Feature Set

Supports both local and remote notifications, custom sounds/icons, Android channels, scheduled repeats, and interactive actions, enabling rich notification experiences.

Detailed Configuration Guides

The README provides step-by-step instructions for manual Android manifest edits and Firebase integration, reducing setup ambiguity for complex use cases.

Cons

Inactive Maintenance

The author explicitly states the repository is not actively maintained, leading to potential bugs, security issues, and lack of updates for new OS versions or React Native changes.

Cumbersome Native Setup

Requires manual configuration of AndroidManifest.xml, Firebase dependencies, and version matching, which is error-prone and increases initial development time.

Platform-Specific Dependencies

iOS functionality depends on the separate PushNotificationIOS library, adding another layer of integration complexity and potential version conflicts.

Frequently Asked Questions

Related Projects

React Native Firebase

🔥 A well-tested feature-rich modular Firebase implementation for React Native. Supports both iOS & Android platforms for all Firebase services.

Stars12,302

Forks2,332

Last commit6 hours ago

react-native-device-info

Device Information for React Native iOS and Android

Stars6,680

Forks1,459

Last commit3 days ago

react-native-fs

Native filesystem access for react-native

Stars5,044

Forks1,012

Last commit2 years ago

react-native-config

Bring some 12 factor love to your mobile apps!

Stars4,956

Forks658

Last commit1 day ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub