Changing the presets
Validate before pushing
npx --yes --package renovate -- renovate-config-validator --strict --no-global *.json
Run it in the preset repo before pushing, because a broken preset causes a config error in every repo that extends it. CI runs the same check on every pull request and weekly, to catch presets broken by new Renovate releases.
Rules for new presets
- A new preset is a modifier: it must not extend
baseordefault. Extending the base from several presets loads it repeatedly and can make Renovate runs hang. - Give it a
descriptionthat starts withModifier, list after github>gander-settings/renovate. - Add a page under
docs/presets/, a row to the preset tables (README.md,docs/index.md) and a link indocs/llms.txt. - Every snippet in the docs is a complete, copy-ready
renovate.json.
Repository layout
default.json github>gander-settings/renovate: base + automerge
base.json base config without automerge
defaults.json deprecated alias of base
automerge.json modifier: automerge rules
forks.json modifier: fork processing
pin.json modifier: pin(<dependency>,<version>)
before.json modifier: before(<package>,<version>)
vue.json modifier: before(typescript,7)
docker.json modifier: docker:pinDigests
legacy.json modifier: one PR per package for minors
approval.json modifier: updates only after dashboard approval
lockfile.json modifier: lock file maintenance on demand
disabled.json modifier: Renovate turned off
docs/ this documentation (GitHub Pages) and llms.txt