Skip to content

Catalog rules

pnpm, yarn and bun catalogs: keep catalog entries, catalog: references and declared versions consistent. Configured with [catalog].

Rule Default severity Fixable
catalog-mismatch error sometimes
catalog-missing-entry warning sometimes
catalog-not-used warning sometimes
unresolved-catalog-references error none
unused-catalog-entries warning none

Fixable is safe (applied by --fix), unsafe (applied only by --fix-unsafe), sometimes (fixable for some findings) or none. See the CLI reference.

A dependency is declared with a version while other packages take it from a catalog.

  • Default severity: error
  • Fixable: sometimes
[rules]
catalog-mismatch = "error"

A dependency that should come from a catalog has no catalog entry.

  • Default severity: warning
  • Fixable: sometimes
[rules]
catalog-missing-entry = "warn"

A dependency that has a catalog entry is declared with a version instead of catalog:.

  • Default severity: warning
  • Fixable: sometimes
[rules]
catalog-not-used = "warn"

A catalog: specifier names a catalog or an entry that does not exist.

  • Default severity: error
  • Fixable: none
[rules]
unresolved-catalog-references = "error"

A catalog entry that no manifest references.

  • Default severity: warning
  • Fixable: none
[rules]
unused-catalog-entries = "warn"