Getting started / Introduction

Introduction

Uplift Funnel writes the activation flows your iOS app is missing, publishes them, measures them and rewrites them — stopping once, for your approval. These docs cover what it does on its own, what it is never allowed to touch, and how to wire it up.

Autopilot is the main road. You connect four things, correct five sentences, and the system builds a profile of your app, plans which flows are missing, writes them in your theme, renders them across devices and languages to check they hold up, and shows you the set once. After that it publishes, experiments and rewrites without asking — inside guardrails you can read, revoke and switch off.

The editor is the escape hatch. Everything autopilot writes is an ordinary flow you can open, change and publish yourself, and you can author from scratch. The MCP server exposes the same surface to a coding agent, so Claude Code or Cursor can read and edit real flows.

Two SDKs, one engine, iOS only. A native Swift package, and a Flutter package that hosts the same engine rather than reimplementing it — so a flow cannot render differently in one than the other. Android, React Native and web are not supported; every call throws off iOS instead of failing quietly.

Start here

OverviewThe state machine autopilot runs, from setup to a flow that rewrites itself — and the one place it stops to ask you.QuickstartFrom a fresh account to autopilot's first set of flows, waiting for your approval.Safety & guardrailsHeadless validation, canary rollout, guardrail rollback, locks, the kill switch, and the audit log.How it worksThe architecture: an app profile, a planner, an authoring loop, serve-time expansion, and a thin native SDK.

Browse the docs

Autopilot

OverviewThe state machine autopilot runs, from setup to a flow that rewrites itself — and the one place it stops to ask you.SetupThe four things you connect, how the SDK step is verified by measurement, and the profile threshold that gates publishing.What it writesThe activation archetypes it picks from, the triggers it attaches, and the two flows it deliberately will not write on day one.The approval gateThe single human touch: what it made, what it intends to do, and what it is never allowed to change.Safety & guardrailsHeadless validation, canary rollout, guardrail rollback, locks, the kill switch, and the audit log.Evidence & claimsThe four evidence levels, the permanent holdout, reconciliation, and how decisions are made when your app is small.

Concepts

Flows, screens & variablesThe building blocks of a funnel: screens, transitions, and the variables they collect.Triggers & presentationHow the server decides which flow appears and when, and how your app keeps the right to say not now.Autonomy levelsL0 to L3: what the system does by itself at each level, what stays yours, and how the ceiling works.In-flow inferenceRunning a model mid-flow on your own provider key, and writing the result back as a typed profile variable.Versions & cachingDrafts, deploys, versioning, and how flows are cached on the server and on devices.A/B experimentsVariants, sticky assignment, adaptive allocation, and reading experiment results with confidence.

Dashboard

Apps, team & audit logOne account, multiple apps: workspaces, roles, invites, and the audit log every autonomous action lands in.AnalyticsFunnel metrics from first open to paid, per-flow breakdowns, and campaign data.Optimizer & growth memoThe opportunities it found, the hypotheses it formed, the experiments it is running, and the weekly written account.Plan & billingWhat the plan screen shows while autopilot is free, and what changes when it is priced.The editorThree panes, three views: where screens, layers, the canvas and the inspector live.Component librarySections and elements, element → variant, and where a click will put them.Layers & selectionPicking the right thing on the canvas, moving layers, copy and paste across flows.ThemingDesign tokens, dark mode variants, saved palettes, and contrast checks.SDK & API keysPublic and secret keys, how they're stored, and how to rotate them safely.

Agents

MCP serverConnect Claude Code, Cursor or any MCP client to your flows: pairing, the six tools, and what an agent is not allowed to do.

iOS SDK (Swift)

Install & configureAdd the Swift package to your app and configure it with your public API key.Rendering flowsUpliftFunnelFlowView: one view that fetches, caches, and renders a flow as SwiftUI.Native handlersWire sign-in, permissions, purchases, photo upload, and links to your own code.Products & paywallsRegister store products so paywall screens show real localized prices.Identity & analyticsidentify, track, attribution, and the events the SDK sends automatically.Caching, offline & errorsCache-first fetching, offline behavior, typed errors, and the advanced session API.

Flutter SDK

Install & configureAdd uplift_funnel_flutter to your app and configure it with your public API key.Rendering flowsThe UpliftFunnelFlow widget: one widget that fetches, caches, and renders a flow natively.Native handlersWire sign-in, permissions, purchases, photo upload, and links to your own code.Products & paywallsRegister store products so paywall screens show real localized prices.Identity & analyticsidentify, track, attribution, and the events the SDK sends automatically.Caching, offline & errorsCache-first fetching, offline behavior, typed errors, and the advanced session API.

Integrations

RevenueCat & AdaptyConnect your subscription backend so revenue shows up in your funnel.WebhooksPush funnel events to your own backend with signed webhooks.AttributionBring AppsFlyer or Adjust campaign data into funnel analytics.

App Store

App Privacy answersExactly what to declare in App Store Connect's App Privacy questionnaire when your app ships the Uplift Funnel SDK.Review complianceWhy over-the-air funnels are within App Store rules, and what the platform blocks before you can publish a paywall.

Not supported

AndroidNot shippedThere is no Android SDK. What a Flutter app does on Android today, and how to guard for it.React NativeNot shippedThere is no React Native SDK and none is planned. What exists today for a React Native app.