Generated project commands

Run these commands from the root of a generated project after pnpm install.

Development

Command	What it does
pnpm start 0	Watch variation 1 (src/js/v1/). Rebuilds on save and copies IIFE bundle to clipboard.
pnpm start 1	Watch variation 2 (src/js/v2/). Clipboard copy enabled.
pnpm start N	Watch the variation at zero-based discovered order. Numeric vN folders come first, then named folders such as control.
pnpm dev	Watch all variations simultaneously. No clipboard copy.

Build

Command	What it does
pnpm build	Production build. Runs Biome lint first. Builds all variations to dist/. Aborts on lint errors.
pnpm live	Opens targetUrl, watches the selected bundle, and injects it into the page.
pnpm new-variation N	Creates src/js/vN/index.jsx from v1.
pnpm new-variation control	Creates src/js/control/index.jsx from v1.

To generate an impression-only control at project creation time, pass --control to the package CLI:

npx @sogody/experiment-framework my-experiment --control

Unlike pnpm new-variation control, the generator flag creates an entry that observes the native page and does not copy the variant UI.

The build writes:

dist/
├── v1-index.jsx   ← IIFE bundle for variation 1
├── v2-index.jsx   ← IIFE bundle for variation 2
├── vN-index.jsx
└── control-index.jsx

Linting

Command	What it does
pnpm lint	Runs biome check src. Reports violations without writing files.
pnpm format	Runs biome check --write src. Formats files and applies safe fixes.

Live injection options

pnpm live -- --variation v2
pnpm live -- --variation control
pnpm live -- --url https://www.samsung.com/de/
pnpm live -- --overlay hidden
pnpm live -- --profile shared

CLI flags override the matching values in experiment.config.js. --variation accepts a zero-based index or a discovered folder name such as v2 or control.

Testing

Command	What it does	Available
pnpm test:e2e	Runs Playwright tests in e2e/.	Only when E2E was enabled at scaffold time

AI project support

New projects already contain tracked AGENTS.md and CLAUDE.md files. After upgrading an older project to 2.2.0, create or refresh them with the package binaries:

pnpm exec exp-init-agents
pnpm exec exp-init-claude

exp-init-agents updates only the framework-managed block when it finds valid markers. Add --force to replace an unmarked file intentionally. exp-init-claude still refuses an existing file unless you pass --force.

See AI Project Support for the version-matched documentation flow.

Notes

• pnpm build aborts on lint errors.
• Watch commands block an invalid bundle but keep the watcher running for the next save.
• All commands require Node 20.19+ and pnpm >=10.26.0. Run nvm use first so the generated .nvmrc selects the project Node version. pnpm 11 requires Node 22 or newer.