integrating-superwall-expo

Installation
SKILL.md

Integrating Superwall in React Native Expo (expo-superwall)

Why this skill exists

Superwall’s Expo SDK (expo-superwall) is native-module based, so Expo Go won’t work and setup mistakes often look like “Cannot find native module 'SuperwallExpo'”. This skill provides a reliable, repeatable workflow to:

  • install + configure expo-superwall correctly in Expo SDK 53+
  • present paywalls via placements (remote campaigns) and implement feature gating
  • manage users + attributes, and keep subscription status in sync (including RevenueCat)
  • wire deep links / web checkout, and troubleshoot the common integration failures

Non‑negotiables (check first)

  1. Expo SDK 53+ is required for expo-superwall.
  2. Expo Go is not supported. Use an Expo Development Build (npx expo run:ios|android or EAS dev client).
  3. Target minimum OS versions:
    • iOS deployment target: 15.1+
    • Android minSdkVersion: 21+
  4. Superwall config does not refetch during hot reload. After dashboard changes (paywalls/products/campaigns), fully restart the app.
Related skills
Installs
49
GitHub Stars
1
First Seen
Feb 27, 2026