Headless SDK

Build your funnel UI with React and TypeScript. AppFunnel handles the infrastructure — sessions, payments, routing, tracking, and integrations — so you only write the UI layer.

Each funnel page is a React component in src/pages/*.tsx. Hooks like useResponse, useNavigation, and useProducts give you access to the full runtime. Develop locally with appfunnel dev (Vite + HMR), build with appfunnel build, and ship with appfunnel publish.

The Headless SDK is designed to be AI-friendly. Point an AI coding assistant like Claude Code at these docs and it can scaffold, build, and iterate on a complete funnel — pages, routing, payments, and all — without you writing a single line of code yourself.

What the SDK provides

Hooks — useVariable, useVariables, useNavigation, useProducts, useUser, useKeyboard, useSafeArea for accessing and updating funnel state.
Interactive elements — Pre-built components like SingleSelect, MultiSelect, ProgressBar, SpinnerWheel, Dialog, Drawer, Carousel, Marquee, and CountUp that handle common funnel patterns out of the box.
Payment components — StripePaymentForm and PaddleCheckout for integrating payment flows with minimal setup.
External API — A window.appfunnel object that exposes funnel state and actions to non-React code (analytics snippets, third-party scripts, etc.).
Local development — appfunnel dev starts a Vite dev server with hot module replacement so you can iterate quickly.

When to use Headless

	No-Code Editor	Headless SDK
Best for	Marketers, quick visual iterations	Developers, rapid iteration with AI tools like Claude Code
UI control	Template-based, drag & drop	Full React component tree
Logic	Built-in conditions	Arbitrary TypeScript
Deployment	Publish from the dashboard	`appfunnel build` + `appfunnel publish`
Collaboration	Non-technical team members can edit	Requires developer workflow

Choose the Headless SDK when you need custom animations, complex branching logic, shared component libraries, or tight integration with your existing design system. Choose the No-Code Editor when speed and accessibility for non-technical teammates matter most.