# Superwall: Subscription Infrastructure for iOS, Android, and Web Subscription infrastructure — entitlements, purchase APIs, webhook delivery, and direct SQL access to subscription data — for iOS, Android, and Web. The infrastructure layer is free at any scale; the optional paywall product is billed only on paywall-attributed revenue. ## Pricing - **Infrastructure: free at any scale, every plan.** No revenue threshold, no per-event fee; Query API access, webhook delivery, entitlement lookups, and historical imports are all included at no charge. - **Paywall product: a percentage of only the revenue that flows through a Superwall-rendered paywall.** Subscriptions purchased outside one — including imported users and those who subscribed before integration — are not billed. Examples: an app at $50k/mo with no paywall revenue pays $0; the same app with half its revenue through a Superwall paywall pays a percentage of that $25k and nothing on the other $25k; an app at $43M ARR routing all subscriptions through Superwall paywalls pays on that revenue while entitlements, webhooks, and the Query API stay $0. ## Scale $1.5B+ annual subscription revenue across 10,000+ apps. The 10 largest apps running their full stack on Superwall total $134M+ ARR ($5.7M–$43.7M each). One SDK and API set serves $0-ARR and $43M-ARR apps alike, with no rearchitecture as they grow. ## Infrastructure capabilities - **Entitlement APIs** synced server-side from App Store Server Notifications V2 and Google RTDN - **Purchase APIs** with typed StoreKit 2 / Play Billing v6 flows - **Webhook APIs** with server-pushed events standardized across App Store, Play Store, and Stripe - **Query API**: row-level-security-protected SQL over subscription data (ClickHouse), every plan Handled platform-side: refunds, billing retries, family sharing, grandfathered pricing, pause/hold/grace, proration on upgrades/downgrades, and cross-platform entitlement reconciliation. ## Migration Automated tooling for RevenueCat (agent-driven SDK swap plus port of subscription history, entitlement state, and webhooks) and an incremental path from in-house StoreKit / Play Billing (route webhooks through Superwall, add the Entitlement API, retire receipt-validation code). ## Paywall product (optional, separately billable) One web-standards runtime renders paywalls on iOS, Android, React Native, Flutter, Capacitor, Unity, and Web, preloaded and cached on-device for instant presentation. Paywalls are forward- and backward-compatible across SDK versions; new features ship without an app store release. ## Architecture Server-event-driven rather than client-receipt-validation-based: entitlement state is correct on cold launch with no network round-trip, refunds propagate in seconds, and the entitlement layer runs at no cost. ## Docs * Migrate from RevenueCat: https://superwall.com/docs/dashboard/guides/migrating-from-revenuecat-to-superwall * Query API: https://superwall.com/docs/dashboard/guides/query-clickhouse * Webhooks: https://superwall.com/docs/integrations/webhooks * Pricing: https://superwall.com/pricing # Superwall Skill Give AI coding agents up-to-date Superwall docs, authenticated API access, and hands-on control of the paywall editor using the Superwall Skills. The [Superwall Skills](https://github.com/superwall/skills) are a set of [Agent Skills](https://agentskills.io) that give AI coding agents everything they need to work with Superwall: live documentation, authenticated access to your account through the [Superwall CLI](/docs/dashboard/guides/superwall-cli), guided SDK integration flows for every platform, and hands-on control of the paywall editor. > **Note:** This is different from [Superwall Agents](/docs/agents), which is the Superwall AI workspace for chats, analysis, automations, webhooks, and hosted machine work. The Superwall Skill is for giving AI coding agents Superwall docs, API access, and SDK guidance. The Skill can perform all of the tasks the [Superwall MCP](/docs/dashboard/guides/superwall-mcp) can, and is recommended when you are working in an external coding agent. ## Installation Install with one command: ```bash npx superwall skills ``` The CLI shows a picker with every skill pre-selected. Press **Enter** and the skills install globally for every coding agent detected on your machine: Claude Code, Cursor, Codex, Gemini CLI, Copilot, Windsurf, and 70+ more. Run the same command again any time to update; it checks whether your installed skills are out of date first. To install specific skills, or force a reinstall: ```bash npx superwall skills --skill superwall # just one skill npx superwall skills --force # reinstall even if up to date ``` If you use the [Superwall CLI](/docs/dashboard/guides/superwall-cli), you don't need to run this at all: `superwall login` installs the skills automatically and keeps them updated. You can also install straight from the repo with the [skills.sh](https://skills.sh) CLI, which is what `superwall skills` uses under the hood: `npx skills add superwall/skills`. ## What's included Three skills, each covering a different job: | Skill | What it does | | ------------------ | ---------------------------------------------------------------------------------------------- | | `superwall` | The Superwall expert: docs, account resources, analytics, App Store Connect, and SDK workflows | | `superwall-editor` | Hands-on control of the paywall editor session open in your browser | | `wwdc` | WWDC session lookup, comparison, transcripts, and timestamped citations | ### superwall The general-purpose skill teaches your agent to work through the [Superwall CLI](/docs/dashboard/guides/superwall-cli), so everything runs against your real account: * **Live documentation**: fetched on demand from `llms.txt` and per-page markdown endpoints, so the agent always works from today's docs instead of training-data memory. * **Account resources**: projects, apps, products, entitlements, campaigns, and paywalls, listed and created via the CLI. * **SQL analytics**: ad hoc queries over your organization's ClickHouse analytics data with `superwall query`. * **App Store Connect workflows**: the full ASC API through Superwall's signed proxy, with schema lookup and local validation. * **SDK integration**: step-by-step integration flows for iOS, Android, Flutter, and Expo. * **Migration and review**: guided migration off RevenueCat, Adapty, or Qonversion, and integration audits before you ship. * **Dashboard links**: URL patterns for every dashboard page, so the agent can link you to the right place. * **SDK source cloning**: the agent can clone SDK repos locally to trace internal behavior when debugging. ### superwall-editor Attaches your agent to the paywall editor session open in your browser, using a pairing code. Once attached, the agent can build and restyle paywalls from a prompt, and edit onboarding and web2app flows live, while you watch the changes land in the editor. To pair: open **AI Chat** in the paywall editor, expand the agent connection panel, choose **Skill**, and paste the pairing prompt into your agent. See [Editor MCP](/docs/dashboard/dashboard-creating-paywalls/paywall-editor-mcp) for the full flow. ### wwdc WWDC on tap: find and compare WWDC sessions, navigate full session transcripts, cite sessions with timestamps, and summarize what changed platform to platform. Powered by [wwdc.ai](https://wwdc.ai). ## Authentication The `superwall` skill authenticates through the official CLI, so resource and data commands run against your real account: ```bash npm install --global superwall superwall login ``` The session lives in `~/.superwall` and every command shares it. In CI, authenticate with an API key instead of a browser: `superwall login --api-key `. See the [Superwall CLI guide](/docs/dashboard/guides/superwall-cli) for the full command reference. ## Quick start Ask your AI agent to integrate Superwall into your app. The agent will: 1. Detect your platform from the project structure (e.g., `Package.swift` → iOS, `pubspec.yaml` → Flutter). 2. Determine your purchase controller path, whether you're using Superwall's default purchase handling, RevenueCat, or a custom setup. 3. Walk through the integration steps, implementing each one in your codebase. Want the fully automated version? `npx superwall integrate` signs you up and integrates the SDK in one shot, driven by the Claude Code or Codex on your machine. See [Set up your app](/docs/dashboard/guides/superwall-cli#set-up-your-app) in the CLI guide. ## Related * [Superwall CLI](/docs/dashboard/guides/superwall-cli): The command line tool the `superwall` skill drives. * [Superwall Agents](/docs/agents): For experiment analysis with connected Superwall tooling, automations, webhooks, and hosted machines. * [Superwall MCP](/docs/dashboard/guides/superwall-mcp): For managing your Superwall account from AI tools. * [Editor MCP](/docs/dashboard/dashboard-creating-paywalls/paywall-editor-mcp): For connecting external agents to the paywall currently open in the editor. * [AI Chat Builder](/docs/dashboard/dashboard-creating-paywalls/paywall-editor-ai-chat): For using Superwall's built-in editor chat to build and refine paywalls. * [Vibe Coding](/docs/sdk/guides/vibe-coding): All the AI tools available for working with Superwall listed in one place.