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 and Android SDK 23 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.

The iOS SDK bundled with Expo SDK v1.6.0 requires Xcode 26 or later to build. SuperwallKit 4.18.0 supports iOS 15 and later; the Expo SDK's deployment target remains 15.1 for Expo SDK 53–55.

Expo SDK v1.5.0 upgrades Google Play Billing to 9.1.0. If your app or another SDK uses Google Play Billing directly, review Google's Billing Library 9 migration guide and test your purchase flows before upgrading.

If your iOS app uses the Superwall MMP or sets an AppsFlyer ID, declare collection of public IP addresses in your app's privacy manifest. See the iOS privacy labels guide for collected-data details.

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": 23
          },
          "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