Getting started
Quickstart hosted
Run the hosted API and Studio locally against Postgres.
Hosted mode runs the same product shape used in staging: API, Studio, Better Auth, and Postgres.
export DATABASE_URL=postgres://...
export BETTER_AUTH_SECRET=$(node -e "console.log(crypto.randomBytes(32).toString('hex'))")
export MANIFEST_KEY_ENC_KEY_HEX=$(node -e "console.log(crypto.randomBytes(32).toString('hex'))")
export FX_BASE_URL=http://localhost:4000
pnpm --filter @fabricorg/experiments-api devIn another shell:
export FX_API_BASE_URL=http://localhost:4000
export NEXT_PUBLIC_FX_API_BASE_URL=http://localhost:4000
pnpm --filter @fabricorg/experiments-studio devThen open http://localhost:3000, sign up, verify the email link from the API logs, create or select an organization, and list experiments.
Required services
- Any standard Postgres-compatible database.
- Neon is recommended for hosted/serverless staging, but not required.
- Optional Resend/OAuth env vars for production-like auth emails and social login.