fyrer.yml Configuration File: Complete Field Reference

fyrer reads a fyrer.yml file in the current directory (or the path passed to --config). The file declares the config format version, global environment variables, cache settings, and a list of packages with their tasks. fyrer validates the file at startup and resolves all paths relative to the directory that contains fyrer.yml.

Top-level structure

fyrer.yml

version: 1                # Required. Must be 1.
cache:
  provider: local         # Cache backend. Only "local" is available.
env:                      # Variables available to all packages and tasks.
  NODE_ENV: development
packages:                 # List of packages in your monorepo.
  - name: web
    root: ./apps/web
    tasks:
      dev:
        cmd: bun run dev
        persistent: true

Top-level fields

Field	Type	Required	Description
`version`	integer	Yes	Config format version. Must be `1`.
`cache`	object	No	Cache configuration.
`cache.provider`	string	No	Cache backend. Only `"local"` supported.
`env`	map	No	Environment variables for all packages.
`packages`	array	Yes	List of package definitions.

Where to place fyrer.yml

Place fyrer.yml at the root of your monorepo — the directory that is the common ancestor of all your packages. Run fyrer from that same directory so that package root paths and task glob patterns resolve correctly. If you need to point at a different file, pass the --config flag:

fyrer --config path/to/fyrer.yml run

fyrer validates the config at startup. Errors are reported with the package and field name so you can find and fix them quickly.

Next steps

Packages

Configure package names, roots, and env files

Tasks

Configure commands, caching, dependencies, and more

Environment

Environment variable precedence and .env files

Get Started

Core Concepts

Configuration

CLI Reference

Guides

fyrer.yml Configuration File: Complete Field Reference

Top-level structure

Top-level fields

Where to place fyrer.yml

Next steps

Packages

Tasks

Environment

​Top-level structure

​Top-level fields

​Where to place fyrer.yml

​Next steps

Packages

Tasks

Environment

Top-level structure

Top-level fields

Where to place fyrer.yml

Next steps