Skip to content

React Native SDK quick start

Get started with the Pushwoosh React Native SDK using this quick and simple example

To integrate the Pushwoosh React Native SDK into your app, you will need the following:

Terminal window
# Clone the SDK repository and navigate to the example project
git clone https://github.com/Pushwoosh/pushwoosh-react-native-plugin.git
# Navigate to example directory
cd pushwoosh-react-native-plugin/example/demoapp/

Install the dependencies:

Terminal window
npm install

Open Settings.js and update the Pushwoosh.init call:

Pushwoosh.init({ "pw_appid" : "__YOUR_APP_ID__", "project_number":"__YOUR_FCM_SENDER_ID__"});

Replace __YOUR_APP_ID__ and __YOUR_FCM_SENDER_ID__ values with your Pushwoosh App Code and Firebase Project Number.

Navigate to the ios directory and install the dependencies:

Terminal window
cd ios && pod install --repo-update

Open the ios/Runner.xcworkspace file in Xcode.

Set the Bundle Identifier for each target:

  • Runner: your app’s package name. (eg. com.example.pushwoosh)
  • NotificationService: your app’s package name with .NotificationServiceExtension (eg. com.example.pushwoosh.NotificationServiceExtension)

In your ios/Runner/Info.plist set the Pushwoosh_API_TOKEN key to the Pushwoosh Device API Token

Copy your google-services.json file to the android/app directory

Open android/app/build.gradle and set the applicationId to your app’s package name. (eg. com.example.pushwoosh)

Open your android/app/src/main/AndroidManifest.xml file and add the following metadata inside the <application> tag:

AndroidManifest.xml
<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />

Replace __YOUR_PUSHWOOSH_DEVICE_API_TOKEN__ with your Pushwoosh Device API Token.

  1. Build and run the project.
  2. The app will have two tabs: “Actions” and “Settings”. Navigate to the Settings tab.
  3. Tap the Register for Push Notifications button.
  4. Grant permission for push notifications. The device will be registered with Pushwoosh.

Go back to the Pushwoosh Control Panel and send a push notification to your registered device.