Crossdeck Docs

One SDK. Subscriptions, analytics, and errors.

Install the SDK once. Verify revenue across Apple, Google Play, and Stripe. Capture behavioural events, sessions, and runtime errors — all attached to the same customer record. Setup is layered, evidence-based, and observable end-to-end.

Jump to: Web SDK isEntitled captureError Connect Stripe Identify users Source maps

Quickstart

Three paths to your first verified signal.

Pick the surface you're shipping. Each guide takes about ten minutes and ends with a verified signal in the Crossdeck dashboard — covering all three pillars: subscriptions, analytics, and errors.

~ 10 min

Web quickstart

Install @cross-deck/web, identify the user, capture your first error, and check an entitlement — all from one snippet.

Start

~ 10 min

iOS quickstart

Add the Swift Package, configure with your public SDK key, send your first event, capture an error, and verify entitlement state.

Start

Browse by area

Start with the part you're implementing.

Getting started

Set up the project, register your apps, and verify the first signal.

SDKs & CLI

One mental model across browser, server, and CI. Same lifecycle, same API shape.

Bolt-ons & guides

Pattern docs that turn the SDK from "events landing" into bank-grade observability.

Payment rails

Connect Apple, Google, and Stripe with verified webhooks and signed events.

Products & entitlements

Products are what users buy. Entitlements are what your app unlocks.

Revenue intelligence

Track revenue state in real time as it changes — across every rail.

Workbench

Query your payment rails directly and read their authoritative truth — live, precise, read-only.

Analytics

Privacy-safe product behaviour — sessions, page views, custom events — joined to revenue and errors.

Errors

Capture uncaught exceptions, network failures, and runtime errors — with the paying customer attached. Real-time on every tier.

Support

Billing, answers to the questions developers actually ask, and the fastest route to a human.

Get a feel

One SDK. All three pillars.

Configure once. Identify users. Track behaviour. Capture errors. Ask Crossdeck for entitlement state. Same shape on iOS, Android, web — and the server when v2.0 ships.

The six primitives

Crossdeck SDKs expose the same lifecycle in platform-native syntax. Learn it once, recognise it everywhere.

init (Web) / start (iOS, Android) — initialise with your app ID, public SDK key, and environment
identify — link the current user to your auth ID
track — send a behavioural event (page view, action, custom)
captureError — report an exception with optional context
isEntitled — ask for the verified access state
syncPurchases — forward purchase evidence for verification

Crossdeck SDK

import Crossdeck

// Auto-tracks app lifecycle + screen views and uncaught errors.
// start() throws on misconfig; degrade rather than crash launch.
let cd = try? Crossdeck.start(options: CrossdeckOptions(
    appId: "app_ios_acme01",
    publicKey: "cd_pub_live_xxx",
    environment: .production
))

if let userId = AuthService.shared.currentUser?.id {
    await cd?.identify(userId)
}

// Behavioural event
cd?.track("checkout_started", properties: ["product": "annual_pro"])

// Manually report a caught error
do { try await processCheckout() }
catch { cd?.captureError(error) }

// isEntitled is sync — microsecond cache read
if cd?.isEntitled("pro") == true {
    showProFeatures()
}

import { Crossdeck } from "@cross-deck/web"

// One init. Subscriptions + analytics + errors all activate together.
// Auto-tracks page.viewed, sessions, and uncaught errors.
Crossdeck.init({
  appId: "app_web_acme01",
  publicKey: "cd_pub_live_xxx",
  environment: "production",
})

// After your auth resolves the signed-in user
if (session?.user?.id) await Crossdeck.identify(session.user.id)

// Behavioural event
Crossdeck.track("checkout_started", { product: "annual_pro" })

// Manually report a caught error
try { await processCheckout() }
catch (err) { Crossdeck.captureError(err) }

// Real-time entitlement check — under 50ms, no await.
if (Crossdeck.isEntitled("pro")) showProFeatures()

Install with AI tools

Built for the AI-assisted development era.

Pick your stack — we generate a phased install prompt with your App ID and publishable key prefilled. Paste into Cursor, Claude Code, Gemini, or any AI tool that takes Markdown. The AI installs one phase at a time, you verify the dashboard gate, then continue. No big-bang failures.

Next.js App Router or Pages Router — server actions and edge ready.

React + Vite Vite, Create React App, or any browser bundler.

▲

SwiftUI (iOS) StoreKit 2 first, with App Store Connect setup walkthrough.

Kotlin + Compose (Android) Jetpack Compose, AGP 8.x, Kotlin 1.9+, Play Billing 6.

React Native Expo or bare. iOS + Android in one SDK.

⬢

Node backend Express, Fastify, Hono, or Next.js route handlers.

Need help verifying setup or production state?

The Crossdeck team helps developers verify SDK heartbeat, payment-rail credentials, product mappings, entitlement projections, and the sandbox-to-production handover.

Contact support Start free