@vtex/gatsby-plugin-onesignal

A simple Gatsby plugin to add OneSignal integration into your Gatsby site.

Install

To install this plugin, simply run:

yarn add @vtex/gatsby-plugin-onesignal

or

npm install @vtex/gatsby-plugin-onesignal

Configuration options and defaults

To make this plugin easy to use and fast to setup, we’re using the “Typical Site” integration that OneSignal offers along with customized service worker paths and filenames, to avoid any conflicts with existing service workers your site may already have.

Make sure you have the following selected in your OneSignal admin panel:

Also, in the advanced section, we’re using a few default values that you should change to make this plugin work as is:

Assuming your OneSignal setup is correct, you’re going to receive an appId for your site. This appId is the only required option for this plugin to work, so you should add this to your site’s gatsby-config.js file:

  plugins: [
    {
      resolve: `@vtex/gatsby-plugin-onesignal`,
      options: {
        oneSignalAppId: "YOUR-APP-ID-HERE"
      },
    },
  ]

Here’s a list of all available options for this plugin and their default values: