Expo SDK quick start

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

Prerequisites

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

Download the example project

# Clone the SDK repository and navigate to the example project
git clone https://github.com/Pushwoosh/pushwoosh-expo-plugin-sample.git

# Navigate to example directory
cd pushwoosh-expo-plugin-sample/

Configure the project

1. Install the dependencies:

npm install

2. Initialize Pushwoosh:

Open app/_layout.tsx and update the Pushwoosh.init call:

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

Where:

__YOUR_APP_CODE__ is the application code from the Pushwoosh Control Panel. __YOUR_FCM_SENDER_ID__ is the Firebase project number from the Firebase Console.

3. Set the package name and bundle ID:

Open app.json and set:

package to your app’s package name.
bundleIdentifier to your app’s bundle ID.

4. Set the Pushwoosh Device API token:

Open your app.json file and set Pushwoosh Device API Token for both platforms:

PW_API_TOKEN device API token value for iOS platform.
apiToken device API token value for Android platform.

5. Add Firebase configuration file:

Copy your google-services.json file to the root directory of the project.

Prebuild the app

Generate native code and configure the dependencies for each platform by running prebuild:

npx expo prebuild

Build and run the project

Build the project:

Android
iOS

npx expo run:android

npx expo run:ios

Grant permission for push notifications. The device will be registered with Pushwoosh and push notifications are enabled.

Send a push notification

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