Experiment Docs

Install

Scaffold a new project in one command:

bash

npx @sogody/experiment-framework my-experiment

Start with the learning path. Use the reference pages when you need an exact command, API signature, or market code.

Framework API - runtime helper signatures and examples
Reference hub - CLI prompts, commands, markets, migration, changelog, contributing

The workflow: scaffold → develop → ship

Scaffold the project. The CLI creates a Vite + Preact button experiment from your answers.

bash

npx @sogody/experiment-framework my-experiment

Develop the variation. Every save rebuilds the IIFE bundle and copies it to your clipboard.

bash

cd my-experiment
pnpm start 0   # watches v1, copies to clipboard on save

Paste the clipboard contents into Adobe Target's custom code editor and refresh your preview.

Ship the experiment. The production build creates one self-contained IIFE bundle per variation.

bash

pnpm build
# dist/v1-index.jsx
# dist/v2-index.jsx

Ready to create your first experiment? Start with Quick Start.