SuperwallKit

AI-powered paywalls, subscriptions and experiments for iOS and Mac apps.

Get started · Manual setup · Docs · API reference · Examples

Add Superwall with a single prompt

Paste this into your coding agent. It installs the SDK, sets up entitlements and adds your first paywall.

Install Superwall into my app using the skill at github.com/superwall/skills

Prefer a guided setup? Run this from your app’s folder. It signs you up or in, then runs Claude Code or Codex for you:

npx superwall integrate

Read the agent integration guide for details.

npx superwall migrate

Manual quick start

Install and configure the SDK yourself. Requires Xcode 26 or later.

1. Install the SDK

In Xcode, choose File ▸ Add Package Dependencies… and add this URL, using Up to Next Major Version from 4.0.0:

https://github.com/superwall/Superwall-iOS

pod 'SuperwallKit', '< 5.0.0'

pod install --repo-update

2. Configure the SDK

Create a Superwall account and copy your app’s public API key from the dashboard. Call configure once when your app launches:

import SuperwallKit
Superwall.configure(apiKey: "YOUR_PUBLIC_API_KEY")

3. Register a placement

A placement is a named point in your app where a campaign can show a paywall. On the dashboard, add the premium_feature placement to a campaign and give it a paywall. Then call this where someone opens the feature:

Superwall.shared.register(placement: "premium_feature") {
  // Open your feature here.
}

The campaign decides whether a paywall shows. With no paywall set up, the closure runs straight away. See the iOS guide for purchases and testing.

Platforms

| Platform | Support | | --- | --- | | iOS | iOS 15+ · UIKit and SwiftUI | | macOS | macOS 12+ · native AppKit and SwiftUI · Mac guide | | Mac Catalyst · visionOS | Uses the iOS API |

What you get with Superwall

• Paywalls and onboarding flows: build single paywalls or multi-page onboarding in the dashboard and publish changes without an app release.
• Experiments: target audiences with campaigns and A/B test paywalls, prices and flows.
• Web checkout and funnels: sell through Stripe on the web, send US App Store users to web checkout from a paywall, and share web funnels as links.
• Subscriptions and entitlements: StoreKit 2 purchases with server-side validation, or bring your own purchase controller.
• Retention: free trial reminders, cancellation surveys, abandoned-purchase offers and win-back paywalls.
• Customer Center: a ready-made screen where users manage their subscription.
• Revenue analytics: conversions, trials, MRR, churn and LTV, also available over SQL and webhooks.
• Agent tooling: skills, an MCP server and a CLI so your coding agent can set up and run Superwall.

Examples

• Basic: a starting integration.
• Advanced: purchase controllers, user attributes and delegates.
• macOS: a native SwiftUI Mac app.

Upgrading

See the release notes for changes between versions.

Support and contributing

Read the docs for setup help, or report a bug with your SDK version and steps to reproduce it. To contribute, read the contributing guide.

SuperwallKit is available under the MIT license.