React Native - Package.json (Legacy)

​

Option 1: React-Native package

To use Superwall in your React Native project, add @superwall/react-native-superwall as a dependency in your package.json file by using npm or yarn:

npm install @superwall/react-native-superwall

​

Option 2: Using Expo

If you have an Expo project, you can add the dependency with npx:

npx expo install @superwall/react-native-superwall

Please note that Superwall does not support Expo Go. Expo Go only supports prebuilt Expo libraries; it cannot load third-party SDKs with custom native code. If you are using a managed workflow, create a development build to continue using Expo tools while including Superwall. Otherwise, you will encounter linking errors.

Here’s a quick table to review your installation methods:

​

iOS Deployment Target

Superwall requires iOS 14.0 or higher. Ensure your React Native project’s iOS deployment target is 14.0 or higher by updating ios/Podfile.

platform :ios, '14.0'

​

Android Configuration

For Android projects, you’ll also need to include Superwall’s Maven repository.

npx expo install expo-build-properties

{
  "expo": {
    "plugins": [
      ...
      [
        "expo-build-properties",
        {
          "android": {
            "minSdkVersion": 26
          }
        }
      ]
    ]
  }
}

npx expo install expo-build-properties

{
  "expo": {
    "plugins": [
      ...
      [
        "expo-build-properties",
        {
          "android": {
            "minSdkVersion": 26
          }
        }
      ]
    ]
  }
}

android {
    ...
    defaultConfig {
        ...
        minSdkVersion 26
        ...
    }
}