Experiment Docs

Appearance

Install ​

Scaffold a new project in one command:

bash
npx create-experiment my-experiment

Documentation map ​

Follow the learning path first. Use reference pages only when you need exact commands, API signatures, or market tables.

Start Here

  • Start Here - setup, scaffold prompts, first watcher, first Adobe Target paste
  • Quick Start - minimal scaffold in about ten minutes
  • Prerequisites - Node, pnpm, optional Playwright

Build an Experiment

Run and Ship

Testing

  • Testing - optional Playwright setup, generated files, smoke flow, markets
  • Markets - complete market group reference

Reference

  • Framework API - runtime helper signatures and examples
  • Reference hub - CLI prompts, commands, markets, migration, changelog, contributing
How it works - scaffold → develop → ship

The tooling follows a three-step workflow from scaffold to production.

1. Scaffold - Run the create command and answer a handful of prompts. The CLI generates a complete Vite + Preact project with your chosen boilerplate, variation count, and market configuration.

bash
npx create-experiment my-experiment

2. Develop - Start the watcher for your active variation. On every save, Vite rebuilds the IIFE bundle and copies it to your clipboard automatically.

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.

3. Ship - Run a production build. Every variation compiles to a self-contained IIFE bundle ready to deploy.

bash
pnpm build
# dist/v1/v1.js
# dist/v2/v2.js

Ready to set up your environment? Start with Start Here.

Internal tool - Samsung / Sogody experimentation team