Documentation
Short pages, one topic each, written to be read by people and by coding agents. Every page is also plain Markdown at the same URL with .md appended, and the whole set is in llms-full.txt.
Start
Getting started
Set up SplitHub, connect your app, create an experiment and read its verdict.
How it works
Config file as source of truth, deterministic assignment, exposures and goals, self-hosted vs cloud.
splithub.config.ts
Every field of the config: storage, goals, experiments, variants, traffic, schedule, targeting.
SDKs
React
SplitHubProvider, <Experiment>/<Variant>, useVariant, useValue, useTrack, pageview goals.
Next.js
Middleware, Server Components, redirect experiments without flicker, live overrides.
Drop-in script
sh.js for sites without a build step: redirect experiments, page and click goals, window.splithub.track.
Experiments
Redirect experiments
Test whole pages: match a path, send each variant to its own URL with middleware, a script or short links.
Targeting flows
Country, device, UTM, cookie, time and visitor conditions as a node graph, in the dashboard and in the config.
Goals and revenue
Event, pageview and click goals, revenue props, attribution by first exposure.
Statistics and verdicts
SRM check, z-test with Bonferroni, confidence intervals, P(beat), when a verdict is final.
Tools
CLI reference
init, create, start/pause/finish, status, results, push, pull, login, doctor, review, skills.
MCP server
@splithub/mcp for Claude Code, Cursor and Codex: tools, setup, working rules.
Agent skills
The six skills the CLI installs and how an agent uses them to run tests correctly.
HTTP API
Event ingest with the public key, project endpoints with the API key, live overrides JSON, errors.
Cloud and data
Self-hosted (your database)
The ingest handler, the Store interface, Postgres/MySQL/SQLite/D1, the events table, attribution SQL.
SplitHub Cloud
Dashboard, projects, keys, live overrides, event gate, retention, what is billed.
Alerts, digest, AI reviews
Rules that pause or finish tests, channels, the scheduled digest, AI reviews at start, during progress checks and on finish.
Short links
Weighted and targeted destinations, sticky choice, UTM pass-through, click stats, QR codes.
Plans and limits
Free, packs and Pro side by side, what an exposure is, what happens at the limit.