Implement Push Notifications in Your React Native App Using IBM Cloud Push Notifications Service

2 min read

By: Josephine Justin and Anantha Krishnan K G

Integrate IBM Cloud Push Notifications Service with a React Native app using React Native SDKs

React Native is an open source framework for easy cross-platform, which helps in building the apps using Javascript. This blog post describes the steps to be followed to integrate IBM Cloud Push Notifications Service with a React Native app using its React Native SDKs (available here).

About the app

This blog helps you build a React Native app that shows all the repositories of a GitHub Organization. It also sends a push notification when an issue or a pull request is created/updated/closed. IBM Cloud Functions actions trigger the push notifications. The complete app is available here.

Push Notifications Service

Create and configure a Push Notifications Service instance from the IBM Cloud catalog. You can refer to this tutorial to create and configure the instance.

IBM Cloud Functions

IBM Cloud Functions are used to create GitHub actions and triggers. Please refer to the IBM Cloud Functions doc for details.

Create an action to get all repositories

Refer to getReposAction.js to create a Node.js action. Create the action using IBM Cloud Functions.

let orgName = "Gypsyan"; defines the organization of the GitHub. Modify this to be the same name as your GitHub org.

This action retrieves all the repositories of the GitHub org and returns the details of the repositories:

GitHub org and returns the details

Create an action to listen for Github web-hooks

Create a Node.js action with the code given in ReactNativeAction.js. Make sure to update the apikeyappId, and apiHost. Update the values of these attributes as per the Push Notifications Service instance created in the first step. This action uses the openwhisk package, which is a wrapper around the Apache OpenWhisk APIs.

This action tracks the GitHub activity. Based on the activity, a push notification payload is created that triggers a notification.

GitHub activity

Create a Cloud Functions trigger

Create a trigger and add the ReactNativeAction in the actions field.

Create a Cloud Functions trigger

Add the GitHub webhook

Open the GitHub repository settings and add a webhook with IBM Cloud Functions trigger. Select Issues and Pull Request.

Add the GitHub webhook

GitHub will invoke the IBM Cloud Functions trigger once any issues or pull request event happens in the GitHub org repositories.

GitHub will invoke the IBM Cloud Functions trigger

Configure the client app

Go to the  App.js and add push credentials and Cloud Functions credentials.

Configure the client app

Configure the client app—iOS and Android—using the bmd-push-react-native SDK documentation.

Run the app

Run your app using react-native run-ios or react-native run-android commands.

Register the device for Push Notifications

Click on the bell icon to register the device for push notifications.

Register the device for Push Notifications

Trigger notifications

To test the app, create an issue or pull request in any repository of your GitHub organization.

Trigger notifications

Resources

Be the first to hear about news, product updates, and innovation from IBM Cloud