Configuration

Bivvy uses YAML configuration files to define your project setup.

File Locations

Configuration is loaded and merged in this order (later overrides earlier):

Remote base configs (from extends:)
User global config (~/.bivvy/config.yml)
Project config (.bivvy/config.yml)
Local overrides (.bivvy/config.local.yml) - gitignored

Basic Structure

app_name: "MyApp"

settings:
  default_output: verbose  # verbose | quiet | silent

steps:
  install_deps:
    command: "npm install"

workflows:
  default:
    steps: [install_deps]

Variable Interpolation

Use ${VAR} syntax to interpolate values:

steps:
  setup:
    command: "echo Setting up ${project_name}"

Resolution Priority

Variables are resolved in this order (highest to lowest):

Prompt values from current run
Saved preferences from previous runs
User-defined variables (vars:)
Environment variables
Built-in variables

Built-in Variables

Variable	Description
`${project_name}`	Directory name of the project
`${project_root}`	Absolute path to project root
`${bivvy_version}`	Current Bivvy version

User-Defined Variables

Define reusable values — static strings or shell commands — under the top-level vars: key. See Variables for details.

vars:
  version:
    command: "cat VERSION"

steps:
  tag:
    command: "git tag v${version}"

Environment Variables

Environment variables are available for interpolation:

steps:
  deploy:
    command: "deploy --env ${RAILS_ENV}"

Escaping

Use $${ to escape (outputs literal ${):

steps:
  example:
    command: "echo '$${NOT_INTERPOLATED}'"  # outputs: ${NOT_INTERPOLATED}

Deep Merge Behavior

When multiple config files define the same key:

Objects: Recursively merged (nested keys combined)
Arrays: Replaced entirely (not concatenated)
Scalars: Later value wins

steps:
  deps:
    command: "yarn install"
    env:
      NODE_ENV: development

# .bivvy/config.local.yml
steps:
  deps:
    env:
      NODE_ENV: production
      # command is preserved from base