Android Installation

Add the library to your application class (e.g.

import com.wix.reactnativenotifications.RNNotificationsPackage;

Receiving push notifications


This section is only necessary in case you wish to be able to receive push notifications in your React-Native app.

Push notifications on Android are managed and dispatched using Google's FCM service. The following installation steps are a TL;DR of Google's FCM setup guide. You can follow them to get FCM integrated quickly, but we recommend that you will in the very least have a peek at the guide's overview.

Step #1: Subscribe to Google's FCM

To set FCM in your app, you must first create a google-services.json file. If you have no existing API project yet, the easiest way to go about in creating one is using this step-by-step installation process;

Step #2: Copy google-services.json

After creating google-services.json, copy it into your project's android/app folder.

Step #3: Add google-services package

buildscript {
dependencies {
classpath ''

Step #4: Add firebase-core package and apply google-services plugin

dependencies {
implementation project(':react-native-notifications')
implementation ''
apply plugin: ''

Step #5: Link react-native-notifications

include ':react-native-notifications'
project(':react-native-notifications').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-notifications/lib/android/app')

Step #6: Customize the appearance

It is important to name the icon that you would like to display notification_icon. Android studio allows to generate the appropriate drawables according to the documentation.

<!-- Set custom default icon. This is used when no icon is set for incoming notification messages.
See README( for more. -->
android:resource="@drawable/notification_icon" />
<!-- Set color used with incoming notification messages. This is used when no color is set for the incoming
notification message. See README( for more. -->
android:resource="@color/colorAccent" />

If you want to use a color like in the example above, you also need to define the color value

<color name="colorAccent">#C60C30</color>