SDK Installation

  • Updated on Dec 9, 2025
  • Published on Aug 2, 2021
  • 1 minute(s) read
Prev Next

This guide helps you understand the requirements for SDK setup, installations, and how to initialize it.

Required For Setup

  • An installed Mac with Xcode 
  • An iOS device. The Xcode simulator does not support push notifications, so you must test on a real device.
  • An Apple Push Services Certificate for iOS
  • An Android device or emulator with minimum API 21
  • A Firebase Cloud Messaging Server Key and google-services.json imported in your app
  • Android Studio
your title goes here

Your project's React Native version should be higher than 0.60.0.

Required Installation

1. To add Insider React Native SDK to your project, add your project react-native-insider.

yarn add react-native-insider
// or
npm install react-native-insider

2. Import RNInsider in your project.

import RNInsider from 'react-native-insider';

Initialize SDK

1. Call Init in the componentDidMount inside your app.js (your landing class).  

your title goes here
Keep in mind that "your_partner_name" is the given name of the app panel on the Insider side. You can gather this information from the Insider One team or log in to the Insider panel and navigate it yourself. It is placed on the top right of the panel, next to the username.

app.js

import RNInsider from 'react-native-insider';
import InsiderCallbackType from 'react-native-insider/src/InsiderCallbackType';

class App extends React.Component {
  componentDidMount() {
    RNInsider.init(
      'your_partner_name',
      'group.com.useinsider.InsiderDemo',
      (type, data) => {
        switch (type) {
          case InsiderCallbackType.NOTIFICATION_OPEN:
            console.log('[INSIDER][NOTIFICATION_OPEN]: ', data);
            Alert.alert('[INSIDER][NOTIFICATION_OPEN]:', JSON.stringify(data));
            break;
          case InsiderCallbackType.INAPP_BUTTON_CLICK:
            console.log('[INSIDER][INAPP_BUTTON_CLICK]: ', data);
            Alert.alert(
              '[INSIDER][INAPP_BUTTON_CLICK]: ',
              JSON.stringify(data),
            );
            break;
          case InsiderCallbackType.TEMP_STORE_PURCHASE:
            console.log('[INSIDER][TEMP_STORE_PURCHASE]: ', data);
            Alert.alert(
              '[INSIDER][TEMP_STORE_PURCHASE]: ',
              JSON.stringify(data),
            );
            break;
          case InsiderCallbackType.TEMP_STORE_ADDED_TO_CART:
            console.log('[INSIDER][TEMP_STORE_ADDED_TO_CART]: ', data);
            Alert.alert(
              '[INSIDER][TEMP_STORE_ADDED_TO_CART]: ',
              JSON.stringify(data),
            );
            break;
          case InsiderCallbackType.TEMP_STORE_CUSTOM_ACTION:
            console.log('[INSIDER][TEMP_STORE_CUSTOM_ACTION]: ', data);
            Alert.alert(
              '[INSIDER][TEMP_STORE_CUSTOM_ACTION]: ',
              JSON.stringify(data),
            );
            break;
        }
      },
    );

    RNInsider.registerWithQuietPermission(false);
 
  }

2. Complete the Android and iOS native steps. 

Related articles