Skip to content
Fallow home
All docs pages

Docs home

Config: workspaces

Find the fallow config keys for workspaces, with type, default, allowed values and description.

The config file holds the settings of fallow. How config works explains where fallow finds the file and how files merge.

workspaces

  • Type: object (optional)

Monorepo workspace configuration. patterns adds workspace package roots beyond manifest discovery; changedSince maps exact project-root-relative workspace roots to Git baseline refs. A global changed-since request overrides those per-package baselines.

KeyTypeDefault
patternsstring[][]
changedSincemap of string
settingsmap of object

workspaces.patterns

  • Type: string[]
  • Default: []

Additional workspace patterns (beyond what's in root package.json).

packages is accepted as an older name of patterns, which an older fallow init --toml wrote.

workspaces.changedSince

  • Type: map of string

Git baseline refs keyed by workspace roots, written relative to the project root as fallow list --workspaces prints them. Scopes check, dead-code, dupes and editor diagnostics; health, security and audit ignore it. A global changed-since request takes precedence. Unlisted workspaces and root files remain in full scope. A key that names no workspace, or a ref that Git cannot resolve, leaves every package in full scope with a warning.

workspaces.settings

  • Type: map of object

Settings that apply only to the workspace packages that a key selects. A key is a workspace root relative to the project root, as fallow list --workspaces prints it, or a glob such as packages/*. A single * stays within one path segment. Each value can hold ignoreDependencies and includeEntryExports. A workspace gets the global ignoreDependencies plus the lists of every key that selects it. For includeEntryExports, an exact root wins over a glob, a glob with more literal segments wins over a shorter glob, and a workspace that no key sets uses the global value. The root package uses only the global keys. A key that selects no workspace gives a warning. An older fallow version ignores this map, so pair it with minimumVersion.

KeyTypeDefault
ignoreDependenciesstring[]
includeEntryExportsboolean

workspaces.settings.<key>.ignoreDependencies

  • Type: string[]

Package names or package-name globs that unused-dependency and unlisted-dependency detection ignore in the selected workspaces only, in addition to the global ignoreDependencies. An unused dependency uses the workspace of its package.json. An unlisted dependency uses the deepest workspace of the file that imports it. The syntax is the same as the global ignoreDependencies.

workspaces.settings.<key>.includeEntryExports

  • Type: boolean (optional)

When set, replaces the global includeEntryExports value for the files of the selected workspaces. A file belongs to its deepest workspace. The --include-entry-exports CLI flag turns the check on in every workspace and wins over this value.