Guides

Multi-Environment Setups

Manage development, staging, and production configurations with environment overrides and variable inheritance.

Environment hierarchy

CliFi resolves configuration through a layered system. The base clifi.yaml defines the workflow structure and default variables. Environment files in environments/ override specific values for each target.

Promotion workflow

A typical promotion path moves code from dev to staging to production. CliFi supports this by treating environments as first-class concepts. The same workflow file runs against any environment with the --env flag.

Environment-specific tasks

Use the when condition to gate tasks by environment. This lets you include production-only validation or skip development-only debug steps in production.

Shared configurations

For teams managing many services, use the includes directive to share common environment definitions across projects. Store shared defaults in a central repository and reference them in each service's workflow.