Skip to content

Expo SDK quick start

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

Prerequisites

Anchor link to

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

Download the example project

Anchor link to
Terminal window
# 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

Anchor link to
1. Install the dependencies:
Anchor link to
Terminal window
npm install
2. Initialize Pushwoosh:
Anchor link to

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:
Anchor link to

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:
Anchor link to

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:
Anchor link to

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

Prebuild the app

Anchor link to

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

Terminal window
npx expo prebuild

Build and run the project

Anchor link to
  1. Build the project:
Terminal window
npx expo run:android
  1. Grant permission for push notifications. The device will be registered with Pushwoosh and push notifications are enabled.

Send a push notification

Anchor link to

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