Skip to main content
The providers.yaml file defines default configuration for package providers. These settings apply globally to all packages using a specific provider, unless overridden in individual package configurations.

​
File Structure

The configuration file is an object with provider-specific settings: 
github:
  extra:
    includePrereleases: false
    maxReleases: 10

npm:
  extra:
    tags: [latest]
    npmx: false

python:
  extra:
    maxReleases: 10

docker:
  extra:
    tags: [latest]

​
GitHub Provider

​
github.extra
object
Default settings for GitHub packages.
​
github.extra.includePrereleases
boolean
Include pre-release versions in the release list for all GitHub packages.
​
github.extra.maxReleases
number
Default maximum number of releases to fetch and display for GitHub packages.
Example: 
github:
  extra:
    includePrereleases: false
    maxReleases: 15

​
NPM Provider

​
npm.extra
object
Default settings for NPM packages.
​
npm.extra.tags
array
Default array of NPM dist-tags to track (e.g., latest, next, beta).
​
npm.extra.npmx
boolean
Use npmx.dev instead of npmjs.com as the external link for all NPM packages.
Example: 
npm:
  extra:
    tags: [latest, next]
    npmx: true

​
Python Provider

​
python.extra
object
Default settings for Python packages.
​
python.extra.maxReleases
number
Default maximum number of releases to fetch and display for Python packages.
Example: 
python:
  extra:
    maxReleases: 20

​
Docker Provider

​
docker.extra
object
Default settings for Docker packages.
​
docker.extra.tags
array
Default array of Docker tags to track (e.g., latest, stable).
Example: 
docker:
  extra:
    tags: [latest, stable, alpine]

​
Complete Example

# Default settings for all GitHub packages
github:
  extra:
    includePrereleases: false
    maxReleases: 10

# Default settings for all NPM packages
npm:
  extra:
    tags: [latest]
    npmx: false

# Default settings for all Python packages
python:
  extra:
    maxReleases: 10

# Default settings for all Docker packages
docker:
  extra:
    tags: [latest]

​
Override Behavior

Settings in providers.yaml serve as defaults. You can override them for individual packages in lists.yaml: 
# In providers.yaml
npm:
  extra:
    tags: [latest]

# In lists.yaml - this package overrides the default
- provider: npm
  name: react
  extra:
    tags: [latest, next, experimental]  # Override default

Build docs developers (and LLMs) love

Get started for freeTalk to us