mirror of https://github.com/renovatebot/renovate
115 lines
3.5 KiB
Markdown
115 lines
3.5 KiB
Markdown
![]() |
# Preset configs
|
||
|
|
||
|
Renovate uses the term "presets" to refer to shareable config snippets, similar to eslint. Unlike eslint though:
|
||
|
|
||
|
- Presets may be as small as a list of package names, or as large as a full config
|
||
|
- Shared config files can contain many presets
|
||
|
|
||
|
## Preset config URIs
|
||
|
|
||
|
In human-understandable form, the rules are:
|
||
|
|
||
|
- A full preset URI consists of package name, preset name, and preset parameters, such as `package:preset(param)`
|
||
|
- If a package scope is specified and no package, then the package name is assumed to be `renovate-config`, e.g. `@rarkins:webapp` is expanded to `@rarkins/renovate-config:webapp`
|
||
|
- If a non-scoped package is specified then it is assumed to have prefix `renovate-config-`. e.g. `rarkins:webapp` is expanded to `renovate-config-rarkins:webapp`
|
||
|
- If a package name is specified and no preset name, then `default` is assumed, e.g. `@rarkins` expands in full to `@rarkins/renovate-config:default` and `rarkins` expands in full to `renovate-config-rarkins:default`
|
||
|
- There is a special "default" namespace where no package name is necessary. e.g. `:webapp` (not the leading `:`) expands to `renovate-config-default:webapp`
|
||
|
|
||
|
## Supported config syntax
|
||
|
|
||
|
### Scoped
|
||
|
|
||
|
```
|
||
|
@somescope
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `default` in the npm package `@somescope/renovate-config`.
|
||
|
|
||
|
### Scoped with package name
|
||
|
|
||
|
```
|
||
|
@somescope/somepackagename
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `default` in the npm package `@somescope/somepackagename`.
|
||
|
|
||
|
### Scoped with preset name
|
||
|
|
||
|
```
|
||
|
@somescope:webapp
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `webapp` in the npm package `@somescope/renovate-config`.
|
||
|
|
||
|
### Scoped with params
|
||
|
|
||
|
```
|
||
|
@somescope(eslint, stylelint)
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `default` in the npm package `@somescope/renovate-config` and pass the parameters `eslint` and `stylelint`.
|
||
|
|
||
|
### Scoped with preset name and params
|
||
|
|
||
|
```
|
||
|
@somescope:webapp(eslint, stylelint)
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `webapp` in the npm package `@somescope/renovate-config` and pass the parameters `eslint` and `stylelint`.
|
||
|
|
||
|
### Scoped with package name and preset name
|
||
|
|
||
|
```
|
||
|
@somescope/somepackagename:webapp
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `webapp` in the npm package `@somescope/somepackagename`.
|
||
|
|
||
|
### Scoped with package name and preset name and params
|
||
|
|
||
|
```
|
||
|
@somescope/somepackagename:webapp(eslint, stylelint)
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `webapp` in the npm package `@somescope/somepackagename` and pass the parameters `eslint` and `stylelint`.
|
||
|
|
||
|
### Non-scoped short with preset name
|
||
|
|
||
|
Note: if using non-scoped packages, a preset name is mandatory.
|
||
|
|
||
|
```
|
||
|
somepackagename:default
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `default` in the npm package `renovate-config-somepackagename`.
|
||
|
|
||
|
### Non-scoped short with preset name and params
|
||
|
|
||
|
Note: if using non-scoped packages, a preset name is mandatory.
|
||
|
|
||
|
```
|
||
|
somepackagename:default(eslint)
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `default` in the npm package `renovate-config-somepackagename` with param `eslint`.
|
||
|
|
||
|
### Non-scoped full with preset name
|
||
|
|
||
|
Note: if using non-scoped packages, a preset name is mandatory.
|
||
|
|
||
|
```
|
||
|
renovate-config-somepackagename:default
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `default` in the npm package `renovate-config-somepackagename`.
|
||
|
|
||
|
### Non-scoped full with preset name and params
|
||
|
|
||
|
Note: if using non-scoped packages, a preset name is mandatory.
|
||
|
|
||
|
```
|
||
|
renovate-config-somepackagename:default(eslint)
|
||
|
```
|
||
|
|
||
|
This will resolve to use the preset `default` in the npm package `renovate-config-somepackagename` and param `eslint`.
|