# Experiwall — Full Context for AI Systems

## What is Experiwall?

Experiwall is a paywall design and A/B testing platform built for indie developers and small teams. Creators design paywalls visually in the studio, ship them through a hosted link or a lightweight SDK, and run experiments with configurable traffic splits, audience filters, and real-time conversion analytics. It is web first, with mobile SDKs following. Think Superwall, priced for indie devs. Experiwall also exposes an MCP server so AI tools can read and write paywall configurations.

## How It Works

1. Sign up at experiwall.com/signup and create a project
2. Design a paywall visually in the studio: stacks, text, images, product cards, and buttons
3. Define your products (SKUs, price, trial days, interval) and connect a payment provider
4. Ship the paywall as a hosted link (no install) or render it in your app with the SDK
5. Create a campaign to A/B test variants with a traffic split and audience filter
6. Watch impressions, taps, conversions, and revenue in real time, per variant

## Core Features

### Visual Paywall Studio
- Compose screens from a tree of components: stacks, text, images, product cards, buttons, dividers
- Templates support variables, conditions, and localization via LiquidJS
- Product slots let one design power many SKUs
- Per-screen settings: presentation style, scrolling, gating, cache behavior
- AI screen generation from natural language prompts

### A/B Experimentation
- Campaigns target a paywall with an audience filter and a traffic split across variants
- Configurable traffic splits (e.g. 50/50, 70/30)
- Audience targeting by device type, country, locale, and custom user attributes
- Real-time conversion tracking: impressions, taps, conversions, purchases, revenue per variant
- Variant overrides let each variant tweak the design without duplicating the tree

### Funnels (Web2App)
- Qualify users with a quiz, walk them through info screens, collect payment on the web, then deep-link back into your app
- Versioned so step edits never contaminate previously collected data

### Payments (your account, your money)
- Connect your own payment provider; Experiwall never touches the funds
- Stripe: funds go directly to your Stripe balance
- Polar: one-click Merchant-of-Record checkout via OAuth (handles sales tax, VAT, global compliance)
- MercadoPago: OAuth-connected seller, LATAM-friendly Checkout Pro for one-time payments
- Conversions confirmed server-side and via signed HMAC-SHA256 tokens and webhooks

### Delivery: Hosted or SDK
- Hosted: Experiwall serves the paywall at experiwall.com/p/[paywallId]; share the link, no SDK needed
- Web SDK: @experiwall/react renders experiments, flags, and funnels in a React app
- Mobile SDK: @experiwall/react-native with native rendering and pluggable purchase adapters

### AI Integration
- MCP (Model Context Protocol) server at https://www.experiwall.com/api/mcp
- Lets AI tools like Claude, Cursor, and Windsurf read and write paywall configurations programmatically
- API key authentication via dashboard Settings > API & MCP

### SDKs
- Web: @experiwall/react (npm). Exports: ExperiwallProvider, useExperiwall(), useExperiment(), useTrack(), useFunnel(). Batched analytics events. Paywall rendering components are on the roadmap.
- Mobile: @experiwall/react-native (npm). Exports: ExperiwallProvider, Paywall, PaywallModal, usePaywall(), useExperiwall(). Native rendering, AsyncStorage caching with a 5-minute TTL, batched events, and pluggable purchase adapters (RevenueCat, Expo IAP, custom).

## Pricing

Experiwall offers a free tier and paid plans for higher event quotas and advanced features. Current pricing is at https://experiwall.com/pricing.

## Technical Stack

- Next.js application with React and TypeScript
- Supabase (PostgreSQL) for database and authentication
- Vercel for hosting
- Tailwind CSS for styling

## API

Public SDK endpoints (authenticated via project API key):
- GET /api/sdk/config — returns the resolved screen and product config for a project, evaluating campaign audience filters server-side
- POST /api/sdk/events — receives batched analytics events (impressions, taps, conversions, purchases)

A Management API (bearer-auth with project API keys) reads and writes paywalls, campaigns, funnels, and analytics.

## Documentation

Full documentation is at https://experiwall.com/docs. Each page below covers a specific topic an agent may need to read or reference.

### Getting started
- https://experiwall.com/docs — Documentation overview and section index
- https://experiwall.com/docs/quickstart — Sign up, design your first paywall in the studio, integrate the React SDK, and ship a live A/B test in under ten minutes
- https://experiwall.com/docs/concepts — The four objects you will use every day in Experiwall: paywalls, products, campaigns, and variants

### Paywalls
- https://experiwall.com/docs/paywalls/editor — Compose paywalls visually from stacks, text, images, and product cards. The studio renders the same tree the SDK ships
- https://experiwall.com/docs/paywalls/components — The building blocks every paywall is made of: stacks, text, images, product cards, buttons, and dividers
- https://experiwall.com/docs/paywalls/templates — Use Liquid to interpolate user, product, and locale data into any paywall string
- https://experiwall.com/docs/paywalls/localization — Ship one paywall in many languages and currencies. The runtime picks the right strings and price formatting per user

### Products and payments
- https://experiwall.com/docs/products — Define your SKUs once. Reuse them across every paywall, variant, and campaign
- https://experiwall.com/docs/entitlements — Gate features behind a successful purchase. Entitlements are durable, queryable, and survive plan changes
- https://experiwall.com/docs/payments/stripe — Connect your Stripe account. Funds go directly to your balance. Experiwall never touches the money
- https://experiwall.com/docs/payments/polar — One-click Merchant-of-Record checkout via OAuth. Polar handles sales tax, VAT, and global compliance
- https://experiwall.com/docs/payments/mercadopago — Connect a MercadoPago seller account via OAuth. LATAM-friendly Checkout Pro for one-time payments

### Funnels
- https://experiwall.com/docs/funnels — Qualify users with a quiz, walk them through an info screen, collect payment on the web, then deep-link them back into your app

### SDKs
- https://experiwall.com/docs/sdks/react — Drop-in components for any React app. SSR safe. Zero config beyond an API key
- https://experiwall.com/docs/sdks/react-native — Mobile paywalls with native rendering, AsyncStorage caching, and pluggable purchase adapters for RevenueCat, Expo IAP, and custom flows
- https://experiwall.com/docs/sdks/ios — Native iOS paywall rendering and purchase handling
- https://experiwall.com/docs/sdks/hosted — Ship a paywall without installing the SDK. Share the public URL or redirect users from your app

### Platform
- https://experiwall.com/docs/api — Read and write paywalls, campaigns, and analytics programmatically. Bearer-auth with project API keys
- https://experiwall.com/docs/mcp — Let Claude, Cursor, or any MCP-compatible tool read and write your paywall configurations
- https://experiwall.com/docs/webhooks — Subscribe to purchase and conversion events. Signed with HMAC-SHA256. Idempotent by design

## Contact & Links

- Website: https://experiwall.com
- Sign Up: https://experiwall.com/signup
- Pricing: https://experiwall.com/pricing
- Blog: https://experiwall.com/blog
- RSS Feed: https://experiwall.com/feed.xml
- Email: team@experiwall.com
- Twitter/X: @experiwall
- GitHub: https://github.com/experiwall