# SplitHub

> A/B testing for web apps built with coding agents. Experiments are declared in `splithub.config.ts`, rendered with `@splithub/react` or `@splithub/next` (or the drop-in script), and the verdict is read from the `splithub` CLI, the `@splithub/mcp` server or the dashboard. Events go to your own database (self-hosted, free) or to SplitHub Cloud (50,000 free exposures per project per month, packs from $5, Pro $19/month).

One command sets everything up in a project: `npx splithub` (interactive) or `npx splithub init --mode cloud --yes` (agents). The CLI installs agent skills (.claude/skills, .cursor/rules) and an MCP server entry, so Claude Code, Cursor and Codex know how to create and read experiments.

Every docs page below is also available as raw Markdown by appending `.md` to its URL. The whole documentation in one file: https://splithub.io/llms-full.txt


## Start

- [Getting started](https://splithub.io/docs/getting-started.md): Set up SplitHub, connect your app, create an experiment and read its verdict.
- [How it works](https://splithub.io/docs/concepts.md): Config file as source of truth, deterministic assignment, exposures and goals, self-hosted vs cloud.
- [splithub.config.ts](https://splithub.io/docs/config.md): Every field of the config: storage, goals, experiments, variants, traffic, schedule, targeting.

## SDKs

- [React](https://splithub.io/docs/react.md): SplitHubProvider, <Experiment>/<Variant>, useVariant, useValue, useTrack, pageview goals.
- [Next.js](https://splithub.io/docs/nextjs.md): Middleware, Server Components, redirect experiments without flicker, live overrides.
- [Drop-in script](https://splithub.io/docs/script.md): sh.js for sites without a build step: redirect experiments, page and click goals, window.splithub.track.

## Experiments

- [Redirect experiments](https://splithub.io/docs/redirect-experiments.md): Test whole pages: match a path, send each variant to its own URL with middleware, a script or short links.
- [Targeting flows](https://splithub.io/docs/targeting.md): Country, device, UTM, cookie, time and visitor conditions as a node graph, in the dashboard and in the config.
- [Goals and revenue](https://splithub.io/docs/goals.md): Event, pageview and click goals, revenue props, attribution by first exposure.
- [Statistics and verdicts](https://splithub.io/docs/statistics.md): SRM check, z-test with Bonferroni, confidence intervals, P(beat), when a verdict is final.

## Tools

- [CLI reference](https://splithub.io/docs/cli.md): init, create, start/pause/finish, status, results, push, pull, login, doctor, review, skills.
- [MCP server](https://splithub.io/docs/mcp.md): @splithub/mcp for Claude Code, Cursor and Codex: tools, setup, working rules.
- [Agent skills](https://splithub.io/docs/agent-skills.md): The six skills the CLI installs and how an agent uses them to run tests correctly.
- [HTTP API](https://splithub.io/docs/api.md): Event ingest with the public key, project endpoints with the API key, live overrides JSON, errors.

## Cloud and data

- [Self-hosted (your database)](https://splithub.io/docs/self-hosted.md): The ingest handler, the Store interface, Postgres/MySQL/SQLite/D1, the events table, attribution SQL.
- [SplitHub Cloud](https://splithub.io/docs/cloud.md): Dashboard, projects, keys, live overrides, event gate, retention, what is billed.
- [Alerts, digest, AI reviews](https://splithub.io/docs/alerts.md): Rules that pause or finish tests, channels, the scheduled digest, AI reviews at start, during progress checks and on finish.
- [Short links](https://splithub.io/docs/links.md): Weighted and targeted destinations, sticky choice, UTM pass-through, click stats, QR codes.
- [Plans and limits](https://splithub.io/docs/pricing.md): Free, packs and Pro side by side, what an exposure is, what happens at the limit.

## Site

- [SplitHub: A/B testing in one command](https://splithub.io/)
- [Pricing](https://splithub.io/pricing)
- [Documentation](https://splithub.io/docs)
- [SplitHub compared to other A/B testing tools](https://splithub.io/compare)
- [Free marketing tools](https://splithub.io/tools)
- [UTM generator](https://splithub.io/tools/utm-generator)
- [QR code generator](https://splithub.io/tools/qr-generator)
- [Slack emoji converter](https://splithub.io/tools/slack-emoji-converter)
- [Contact](https://splithub.io/contact)
- [Terms](https://splithub.io/terms)
- [Privacy](https://splithub.io/privacy)

## Packages

- splithub (CLI): https://www.npmjs.com/package/splithub
- @splithub/react, @splithub/next, @splithub/core, @splithub/node, @splithub/stats, @splithub/adapter-sqlite, @splithub/adapter-d1, @splithub/mcp
- Source: https://github.com/andreybo/splithub-ab-testing-platform
- Cloud API base URL: https://go.splithub.io (JSON, no envelope under /v1/*)
- Dashboard: https://app.splithub.io