Quickstart local

The local quickstart proves the experimentation spine without standing up hosted services.

Install the fx command:

npm install -g @fabricorg/experiments
fx --help

In a project with an experiments/ directory:

fx validate experiments/
fx dev &
fx apply experiments/
fx report homepage-cta
fx kill homepage-cta --reason "Web Vitals regression"

If you cannot install globally, use npx @fabricorg/experiments <command> with the same command names.

What happens

1. fx dev starts an in-process control plane and manifest server.
2. fx apply converts YAML into domain actions.
3. The manifest builder produces a delivery manifest.
4. Your app or simulator sends synthetic exposures and conversions.
5. fx report reads aggregate results.
6. fx kill exercises the governed action path and updates the audit trail.

Why start here

Local mode is the fastest way to validate:

• YAML schema and experiment lifecycle,
• deterministic assignment,
• exposure-first attribution,
• reporting and kill actions,
• guardrail behavior before adding hosted complexity.