splithub 0.4.2 → 0.4.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +38 -3
- package/package.json +23 -4
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# splithub
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Experiments and web analytics for your app, from one command. Run it without arguments and it walks you through; add flags and `--json` when a coding agent runs it.
|
|
4
4
|
|
|
5
5
|
```bash
|
|
6
6
|
npx splithub # menu: set up, connect, create, results, start/pause, push — step by step
|
|
@@ -15,6 +15,40 @@ npx splithub results hero-title # cloud: verdict, lift, P(beat), p-valu
|
|
|
15
15
|
npx splithub plan --baseline 0.05 --mde 0.1 # visitors a test needs (asks SplitHub Cloud, no account needed)
|
|
16
16
|
npx splithub report # Markdown for a PR comment (the `ci init` workflow posts it)
|
|
17
17
|
npx splithub doctor # checks config, provider, middleware, route, code references, endpoint
|
|
18
|
+
npx splithub ship hero-title --keep direct # keep the winner in your code, remove the experiment
|
|
19
|
+
npx splithub ci init # GitHub workflow: checks on PRs, results as a PR comment
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Results go deeper in SplitHub Cloud: `--by country` (lift per segment), `--timeline`, `--events` (every event
|
|
23
|
+
per variant), `--filter device=mobile --from 2026-10-01` (a slice), `--export` for CSV.
|
|
24
|
+
|
|
25
|
+
## Analytics
|
|
26
|
+
|
|
27
|
+
One `track()` feeds both: the analytics reports and every experiment that measures that event.
|
|
28
|
+
|
|
29
|
+
```bash
|
|
30
|
+
npx splithub analytics connect # pick or create a property and name it on your provider (or get the sh.js tag)
|
|
31
|
+
npx splithub analytics # every property, last 30 days
|
|
32
|
+
npx splithub analytics sh-x1h78w --by source --compare # also page, channel, country, device, event, goal, variant…
|
|
33
|
+
npx splithub analytics funnel sh-x1h78w --steps "page:/,event:Signup,goal:paid" --within 7d
|
|
34
|
+
npx splithub analytics funnels sh-x1h78w --save Signup --steps "page:/,goal:signup" # saved for the team
|
|
35
|
+
npx splithub analytics funnel sh-x1h78w --funnel Signup # run a saved funnel
|
|
36
|
+
npx splithub analytics paths sh-x1h78w --page /pricing # where visitors go next (--prev: where they came from)
|
|
37
|
+
npx splithub analytics retention sh-x1h78w # who comes back, per weekly cohort
|
|
38
|
+
npx splithub analytics realtime sh-x1h78w # who is on the site now
|
|
39
|
+
npx splithub analytics segments --save "Paid" channel="Paid Search" # saved filters; any report takes --segment Paid
|
|
40
|
+
npx splithub analytics export sh-x1h78w --by page > pages.csv
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
Every report takes `--days 7` or `--from --to`, `--filter country=DE` and `--json`.
|
|
44
|
+
|
|
45
|
+
## Notes, links, alerts
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
npx splithub notes add "Launched the new pricing page" --kind win # shows on every chart
|
|
49
|
+
npx splithub links create https://example.com/spring --slug spring # short link with click counts
|
|
50
|
+
npx splithub alerts add winner --experiment hero-title # also srm, traffic_drop, goal_silent, usage…
|
|
51
|
+
npx splithub domains set property sh-x1h78w example.com # only these sites may send events
|
|
18
52
|
```
|
|
19
53
|
|
|
20
54
|
## Where results come from
|
|
@@ -24,8 +58,9 @@ npx splithub doctor # checks config, provider, middleware,
|
|
|
24
58
|
| `self` | your app's endpoint on the local dev server (`localhost:3000` for Next.js, `5173` for Vite) or `--url` / `SPLITHUB_URL` | `--token` / `SPLITHUB_ADMIN_TOKEN` when the handler has `adminToken` |
|
|
25
59
|
| `cloud` | `https://go.splithub.io/v1` (or `--api` / `SPLITHUB_API`) | project API key: `--token sk_...`, `SPLITHUB_API_KEY`, or the key saved by `splithub login` |
|
|
26
60
|
|
|
27
|
-
Self-hosted reads are raw numbers
|
|
28
|
-
data-quality stars, recommendations
|
|
61
|
+
Self-hosted reads are raw numbers: visitors, conversions, rate and revenue per variant, and counts of
|
|
62
|
+
pages and events per property. Verdicts, data-quality stars, recommendations, sample-size planning and the
|
|
63
|
+
analytics reports (funnels, paths, retention, segments) run in SplitHub Cloud.
|
|
29
64
|
|
|
30
65
|
`init` and `skills` fetch the latest agent skills from SplitHub Cloud and fall back to the copies
|
|
31
66
|
bundled with the CLI when it can't be reached.
|
package/package.json
CHANGED
|
@@ -1,7 +1,26 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "splithub",
|
|
3
|
-
"version": "0.4.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.4.3",
|
|
4
|
+
"description": "Experiments and web analytics for your app in one command: create an A/B test, read a plain verdict, check traffic, funnels and retention. Works for you and for your coding agent.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"splithub",
|
|
7
|
+
"ab-testing",
|
|
8
|
+
"a-b-testing",
|
|
9
|
+
"experiments",
|
|
10
|
+
"split-testing",
|
|
11
|
+
"analytics",
|
|
12
|
+
"web-analytics",
|
|
13
|
+
"product-analytics",
|
|
14
|
+
"funnels",
|
|
15
|
+
"mcp",
|
|
16
|
+
"ai-agents",
|
|
17
|
+
"cli",
|
|
18
|
+
"claude-code",
|
|
19
|
+
"cursor",
|
|
20
|
+
"conversion-rate-optimization",
|
|
21
|
+
"retention",
|
|
22
|
+
"feature-experiments"
|
|
23
|
+
],
|
|
5
24
|
"license": "MIT",
|
|
6
25
|
"repository": {
|
|
7
26
|
"type": "git",
|
|
@@ -23,8 +42,8 @@
|
|
|
23
42
|
"dependencies": {
|
|
24
43
|
"@clack/prompts": "^0.9.1",
|
|
25
44
|
"jiti": "^2.4.2",
|
|
26
|
-
"@splithub/core": "0.4.
|
|
27
|
-
"@splithub/node": "0.4.
|
|
45
|
+
"@splithub/core": "0.4.3",
|
|
46
|
+
"@splithub/node": "0.4.3"
|
|
28
47
|
},
|
|
29
48
|
"devDependencies": {
|
|
30
49
|
"@types/node": "^22.13.0",
|