Welcome to onesignal-expo-plugin 👋

The OneSignal Expo plugin allows you to use OneSignal without leaving the managed workflow. Developed in collaboration with SweetGreen.

• 🏠 Homepage
• 🖤 npm

This plugin is an Expo Config Plugin. It extends the Expo config to allow customizing the prebuild phase of managed workflow builds (no need to eject to a bare workflow). For the purposes of OneSignal integration, the plugin facilitates automatically generating/configuring the necessary native code files needed to get the OneSignal React-Native SDK to work. You can think of adding a plugin as adding custom native code.

• The Expo run commands (expo run:[android|ios])
• Custom clients
• EAS Build

expo install onesignal-expo-plugin
yarn add react-native-onesignal

Add the plugin to the plugin array:

app.json

{
  "plugins": [
    [
      "onesignal-expo-plugin",
      {
        "mode": "development",
      }
    ]
  ]
}

or

app.config.js

export default {
  ...
  plugins: [
    [
      "onesignal-expo-plugin",
      {
        mode: "development",
      }
    ]
  ]
};

You can pass props to the plugin config object to configure:

Add your OneSignal App ID to your Expo constants via the extra param:

Example:

{
  "extra": {
    "oneSignalAppId": "<YOUR APP ID HERE>"
  }
}

You can then access the value to pass to the setAppId function:

import OneSignal from 'react-native-onesignal';
import Constants from "expo-constants";
OneSignal.setAppId(Constants.manifest.extra.oneSignalAppId);

Alternatively, pass the app ID directly to the function:

OneSignal.setAppId("YOUR-ONESIGNAL-APP-ID");

In your configuration file, make sure you set:

* NSE = Notification Service Extension. Learn more about the NSE here.

$ expo prebuild --clean

# Build your native iOS project
$ expo run:ios

# Build your native Android project
$ expo run:android

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Give a ⭐️ if this project helped you!

• Website: https://onesignal.com
• Twitter: @onesignal
• Github: @OneSignal
• LinkedIn: @onesignal

Copyright © 2021 OneSignal.
This project is MIT licensed.