# renovatebot/renovate architecture

> Architecture diagram of the GitHub repository renovatebot/renovate, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/renovatebot/renovate
- Repository: https://github.com/renovatebot/renovate

## Overview

Renovate scans a repository for dependency declarations, resolves each dependency against package registries, and proposes version changes as pull requests. Configuration and package rules shape what is scanned and how updates are grouped or presented; manager and datasource modules provide broad ecosystem coverage. The tree and excerpts establish extraction, configuration, datasource, logging, and SCM Manager HTTP behavior, but not the central orchestration or update-writing implementation. Those stages are represented at the enclosing worker/platform directories, with only documented workflow links shown.

Main entry points: [`lib/workers/repository`](https://github.com/renovatebot/renovate/tree/main/lib/workers/repository) (Update processing), [`lib/config/index.ts`](https://github.com/renovatebot/renovate/blob/main/lib/config/index.ts) (Config processing), [`lib/workers/repository/extract/manager-files.ts`](https://github.com/renovatebot/renovate/blob/main/lib/workers/repository/extract/manager-files.ts) (Manager extraction), [`lib/workers/repository/extract`](https://github.com/renovatebot/renovate/tree/main/lib/workers/repository/extract) (File discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Configuration"]
  node_config["Config processing<br/>[index.ts]"]
  node_presets["Config presets<br/>[index.ts]"]
  node_rules["Package rules<br/>[managers.ts]"]
end

subgraph group_discovery["Dependency discovery"]
  node_file_discovery["File discovery"]
  node_manager_extract["Manager extraction<br/>[manager-files.ts]"]
  node_managers["Package managers"]
  node_dependency_data["Dependency records<br/>[types.ts]"]
end

subgraph group_resolution["Version resolution"]
  node_datasources["Datasource registry<br/>[index.ts]"]
  node_datasource_adapters["Registry adapters"]
end

subgraph group_delivery["Update delivery"]
  node_update_workflow["Update processing"]
  node_repository_platforms["Repository platforms"]
  node_scm_manager["SCM Manager API"]
  node_scm_http["SCM Manager HTTP<br/>[scm-manager.ts]"]
end

subgraph group_operations["Runtime operations"]
  node_logging["Logging<br/>[index.ts]"]
  node_instrumentation["Tracing<br/>[index.ts]"]
end

node_user(("Repository owner"))
node_repo[("Source repository")]
node_registries(("Package registries"))

node_user -->|"sets options"| node_config
node_repo -->|"scans files"| node_file_discovery
node_config -->|"configures scan"| node_file_discovery
node_presets -->|"provides defaults"| node_config
node_config -->|"configures managers"| node_manager_extract
node_file_discovery -->|"provides matched files"| node_manager_extract
node_manager_extract -->|"dispatches extraction"| node_managers
node_manager_extract -->|"produces records"| node_dependency_data
node_rules -->|"matches dependencies"| node_update_workflow
node_update_workflow -->|"requests versions"| node_datasources
node_datasources -->|"dispatches lookup"| node_datasource_adapters
node_datasource_adapters -->|"queries versions"| node_registries
node_registries -->|"returns releases"| node_datasource_adapters
node_update_workflow -->|"proposes updates"| node_repository_platforms
node_repository_platforms -->|"opens pull requests"| node_repo
node_scm_manager -->|"sends requests"| node_scm_http
node_scm_http -.->|"calls SCM Manager"| node_registries
node_update_workflow -->|"emits logs"| node_logging
node_instrumentation -->|"traces execution"| node_update_workflow

click node_config "https://github.com/renovatebot/renovate/blob/main/lib/config/index.ts"
click node_presets "https://github.com/renovatebot/renovate/blob/main/lib/config/presets/index.ts"
click node_rules "https://github.com/renovatebot/renovate/blob/main/lib/util/package-rules/managers.ts"
click node_file_discovery "https://github.com/renovatebot/renovate/tree/main/lib/workers/repository/extract"
click node_manager_extract "https://github.com/renovatebot/renovate/blob/main/lib/workers/repository/extract/manager-files.ts"
click node_managers "https://github.com/renovatebot/renovate/tree/main/lib/modules/manager"
click node_dependency_data "https://github.com/renovatebot/renovate/blob/main/lib/modules/manager/types.ts"
click node_datasources "https://github.com/renovatebot/renovate/blob/main/lib/modules/datasource/index.ts"
click node_datasource_adapters "https://github.com/renovatebot/renovate/tree/main/lib/modules/datasource"
click node_update_workflow "https://github.com/renovatebot/renovate/tree/main/lib/workers/repository"
click node_repository_platforms "https://github.com/renovatebot/renovate/tree/main/lib/modules/platform"
click node_scm_manager "https://github.com/renovatebot/renovate/blob/main/lib/modules/platform/scm-manager/scm-manager-helper.ts"
click node_scm_http "https://github.com/renovatebot/renovate/blob/main/lib/util/http/scm-manager.ts"
click node_logging "https://github.com/renovatebot/renovate/blob/main/lib/logger/index.ts"
click node_instrumentation "https://github.com/renovatebot/renovate/blob/main/lib/instrumentation/index.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_config,node_presets,node_rules toneBlue
class node_file_discovery,node_manager_extract,node_managers,node_dependency_data,node_repo toneAmber
class node_datasources,node_datasource_adapters toneMint
class node_update_workflow,node_repository_platforms,node_scm_manager,node_scm_http toneRose
class node_logging,node_instrumentation,node_user,node_registries toneIndigo
```

## Components

### Configuration

- [Config processing](https://github.com/renovatebot/renovate/blob/main/lib/config/index.ts): `lib/config/index.ts`
- [Config presets](https://github.com/renovatebot/renovate/blob/main/lib/config/presets/index.ts): `lib/config/presets/index.ts`
- [Package rules](https://github.com/renovatebot/renovate/blob/main/lib/util/package-rules/managers.ts): `lib/util/package-rules/managers.ts`

### Dependency discovery

- [File discovery](https://github.com/renovatebot/renovate/tree/main/lib/workers/repository/extract): `lib/workers/repository/extract`
- [Manager extraction](https://github.com/renovatebot/renovate/blob/main/lib/workers/repository/extract/manager-files.ts): `lib/workers/repository/extract/manager-files.ts`
- [Package managers](https://github.com/renovatebot/renovate/tree/main/lib/modules/manager): `lib/modules/manager`
- [Dependency records](https://github.com/renovatebot/renovate/blob/main/lib/modules/manager/types.ts): `lib/modules/manager/types.ts`

### Version resolution

- [Datasource registry](https://github.com/renovatebot/renovate/blob/main/lib/modules/datasource/index.ts): `lib/modules/datasource/index.ts`
- [Registry adapters](https://github.com/renovatebot/renovate/tree/main/lib/modules/datasource): `lib/modules/datasource`

### Update delivery

- [Update processing](https://github.com/renovatebot/renovate/tree/main/lib/workers/repository): `lib/workers/repository`
- [Repository platforms](https://github.com/renovatebot/renovate/tree/main/lib/modules/platform): `lib/modules/platform`
- [SCM Manager API](https://github.com/renovatebot/renovate/blob/main/lib/modules/platform/scm-manager/scm-manager-helper.ts): `lib/modules/platform/scm-manager/scm-manager-helper.ts`
- [SCM Manager HTTP](https://github.com/renovatebot/renovate/blob/main/lib/util/http/scm-manager.ts): `lib/util/http/scm-manager.ts`

### Runtime operations

- [Logging](https://github.com/renovatebot/renovate/blob/main/lib/logger/index.ts): `lib/logger/index.ts`
- [Tracing](https://github.com/renovatebot/renovate/blob/main/lib/instrumentation/index.ts): `lib/instrumentation/index.ts`

### Other components

- **Repository owner**
- **Source repository**
- **Package registries**

## Connections

- Repository owner → Config processing: sets options
- Source repository → File discovery: scans files
- Config processing → File discovery: configures scan
- Config presets → Config processing: provides defaults
- Config processing → Manager extraction: configures managers
- File discovery → Manager extraction: provides matched files
- Manager extraction → Package managers: dispatches extraction
- Manager extraction → Dependency records: produces records
- Package rules → Update processing: matches dependencies
- Update processing → Datasource registry: requests versions
- Datasource registry → Registry adapters: dispatches lookup
- Registry adapters → Package registries: queries versions
- Package registries → Registry adapters: returns releases
- Update processing → Repository platforms: proposes updates
- Repository platforms → Source repository: opens pull requests
- SCM Manager API → SCM Manager HTTP: sends requests
- SCM Manager HTTP → Package registries: calls SCM Manager
- Update processing → Logging: emits logs
- Tracing → Update processing: traces execution
