Configuration

Configuration

Workflow SDK is configured through typed framework options, World factory options, environment variables, and CLI flags.

When more than one surface controls the same setting, the usual precedence is:

explicit option or CLI flag > environment variable > built-in default

Invalid environment variable values do not crash the app. They log a warning and fall back to the default, or to the documented clamp range.

Configuration areas

  • Framework options - build-time and dev-server options for Next.js, Nitro, NestJS, Astro, SvelteKit, and Rollup.
  • Worlds - WORKFLOW_TARGET_WORLD, Local World, Postgres World, and Vercel World configuration.
  • Runtime tuning - replay budgets, inline execution, queue delivery limits, compression, tracing, and advanced runtime escape hatches.
  • Build and diagnostics - public manifests, HMR logs, and source-map controls.
  • CLI and web UI - workflow inspect, workflow web, workflow health, and observability environment overrides.