Install the SDK

This guide is for Expo projects that want to integrate Superwall using our Expo SDK.

This doesn't sound like you?

React Native app, new to Superwall → See our installation guide for bare React Native apps
React Native app with existing Superwall SDK → See our migration guide

Important: Expo SDK 53+ Required

This SDK is exclusively compatible with Expo SDK version 53 and newer. For projects using older Expo versions, please use our legacy React Native SDK.

Expo Go is Not Supported

The Superwall SDK uses native modules that are not available in Expo Go. You must use an Expo Development Build to run your app with Superwall.

To create a development build:

npx expo run:ios
# or
npx expo run:android

If you see the error Cannot find native module 'SuperwallExpo', see our Debugging guide for solutions.

To see the latest release, check out the Superwall Expo SDK repo.

bunx expo install expo-superwall

pnpm dlx expo install expo-superwall

npx expo install expo-superwall

yarn dlx expo install expo-superwall

Version Targeting

Superwall requires iOS 15.1 or higher, as well as Android SDK 21 or higher. Your iOS deployment target must also meet the minimum required by your installed Expo SDK. For Expo SDK 56 and newer, use iOS 16.4 or higher.

First, install the expo-build-properties config plugin if your Expo project hasn’t yet:

npx expo install expo-build-properties

Then, add the following to your app.json or app.config.js file:

{
  "expo": {
    "plugins": [
      ...
      [
        "expo-build-properties",
        {
          "android": {
            "minSdkVersion": 21
          },
          "ios": {
              "deploymentTarget": "15.1" // Use 16.4 or higher for Expo SDK 56+
          }
        }
      ]
    ]
  }
}

And you're done! Now you're ready to configure the SDK

Version Targeting

On this page