# kicad/kicad-source-mirror architecture

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

- Interactive diagram: https://gitdiagram.com/kicad/kicad-source-mirror
- Repository: https://github.com/kicad/kicad-source-mirror

## Overview

KiCad is a multi-application electronic design automation suite: engineers manage projects, edit schematics and boards, check designs, and inspect 3D models. The tree and README identify these product areas, but do not document a complete user-to-result flow. The sampled evidence does show project-manager interactions with package management and the schematic connectivity engine’s relationship to ERC. Other major capabilities are represented as subsystems without inferred call paths; unsampled implementation details are not asserted.

Main entry points: [`kicad/kicad_manager_frame.cpp`](https://github.com/kicad/kicad-source-mirror/blob/master/kicad/kicad_manager_frame.cpp) (Project manager), [`pcbnew`](https://github.com/kicad/kicad-source-mirror/tree/master/pcbnew) (PCB editor), [`kicad/tools/kicad_manager_control.cpp`](https://github.com/kicad/kicad-source-mirror/blob/master/kicad/tools/kicad_manager_control.cpp) (Project actions), [`kicad/pcm/dialogs/dialog_pcm.h`](https://github.com/kicad/kicad-source-mirror/blob/master/kicad/pcm/dialogs/dialog_pcm.h) (Package manager UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_project["Project management"]
  node_project_manager["Project manager"]
  node_project_actions["Project actions"]
  node_package_dialog["Package manager UI<br/>[dialog_pcm.h]"]
  node_package_service["Package manager<br/>[pcm.h]"]
end

subgraph group_design["Design editors"]
  node_schematic_editor["Schematic editor"]
  node_symbol_libraries["Symbol libraries"]
  node_pcb_editor["PCB editor"]
end

subgraph group_checks["Design checks"]
  node_connectivity["Connectivity engine<br/>[conn_engine.h]"]
  node_schematic_erc["Schematic ERC"]
  node_pcb_drc["PCB DRC<br/>[drc_engine.cpp]"]
end

subgraph group_visual["Visualization"]
  node_router_preview["Router preview"]
  node_viewer_controls["3D viewer controls"]
  node_model_cache["3D model cache"]
  node_rendering["3D rendering"]
  node_bitmap_converter["Bitmap converter"]
end

subgraph group_shared["Shared services"]
  node_settings["Settings manager"]
  node_library_manager["Library manager"]
end

node_engineer(("Engineer"))

node_engineer -.->|"uses"| node_project_manager
node_project_manager -.->|"dispatches"| node_project_actions
node_project_manager -->|"references"| node_package_service
node_project_actions -->|"opens"| node_package_dialog
node_package_dialog -.->|"manages packages"| node_package_service
node_schematic_editor -.->|"uses"| node_connectivity
node_connectivity -->|"supplies checks"| node_schematic_erc
node_pcb_editor -.->|"runs checks"| node_pcb_drc
node_pcb_editor -->|"renders preview"| node_router_preview
node_engineer -.->|"edits"| node_schematic_editor
node_engineer -.->|"edits"| node_pcb_editor

click node_project_manager "https://github.com/kicad/kicad-source-mirror/blob/master/kicad/kicad_manager_frame.cpp"
click node_project_actions "https://github.com/kicad/kicad-source-mirror/blob/master/kicad/tools/kicad_manager_control.cpp"
click node_package_dialog "https://github.com/kicad/kicad-source-mirror/blob/master/kicad/pcm/dialogs/dialog_pcm.h"
click node_package_service "https://github.com/kicad/kicad-source-mirror/blob/master/kicad/pcm/pcm.h"
click node_schematic_editor "https://github.com/kicad/kicad-source-mirror/tree/master/eeschema"
click node_symbol_libraries "https://github.com/kicad/kicad-source-mirror/blob/master/eeschema/symbol_library_manager.cpp"
click node_pcb_editor "https://github.com/kicad/kicad-source-mirror/tree/master/pcbnew"
click node_connectivity "https://github.com/kicad/kicad-source-mirror/blob/master/eeschema/connectivity/conn_engine.h"
click node_schematic_erc "https://github.com/kicad/kicad-source-mirror/blob/master/eeschema/connectivity/conn_engine_erc.cpp"
click node_pcb_drc "https://github.com/kicad/kicad-source-mirror/blob/master/pcbnew/drc/drc_engine.cpp"
click node_router_preview "https://github.com/kicad/kicad-source-mirror/blob/master/pcbnew/router/router_preview_item.cpp"
click node_viewer_controls "https://github.com/kicad/kicad-source-mirror/blob/master/3d-viewer/3d_viewer/tools/eda_3d_controller.cpp"
click node_model_cache "https://github.com/kicad/kicad-source-mirror/blob/master/3d-viewer/3d_cache/3d_plugin_manager.cpp"
click node_rendering "https://github.com/kicad/kicad-source-mirror/tree/master/3d-viewer/3d_rendering"
click node_settings "https://github.com/kicad/kicad-source-mirror/blob/master/common/settings/settings_manager.cpp"
click node_library_manager "https://github.com/kicad/kicad-source-mirror/blob/master/common/libraries/library_manager.cpp"
click node_bitmap_converter "https://github.com/kicad/kicad-source-mirror/blob/master/bitmap2component/bitmap2component.cpp"

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_project_manager,node_project_actions,node_package_dialog,node_package_service toneBlue
class node_schematic_editor,node_symbol_libraries,node_pcb_editor toneAmber
class node_connectivity,node_schematic_erc,node_pcb_drc toneMint
class node_router_preview,node_viewer_controls,node_model_cache,node_rendering,node_bitmap_converter toneRose
class node_settings,node_library_manager,node_engineer toneIndigo
```

## Components

### Project management

- [Project manager](https://github.com/kicad/kicad-source-mirror/blob/master/kicad/kicad_manager_frame.cpp): `kicad/kicad_manager_frame.cpp`
- [Project actions](https://github.com/kicad/kicad-source-mirror/blob/master/kicad/tools/kicad_manager_control.cpp): `kicad/tools/kicad_manager_control.cpp`
- [Package manager UI](https://github.com/kicad/kicad-source-mirror/blob/master/kicad/pcm/dialogs/dialog_pcm.h): `kicad/pcm/dialogs/dialog_pcm.h`
- [Package manager](https://github.com/kicad/kicad-source-mirror/blob/master/kicad/pcm/pcm.h): `kicad/pcm/pcm.h`

### Design editors

- [Schematic editor](https://github.com/kicad/kicad-source-mirror/tree/master/eeschema): `eeschema`
- [Symbol libraries](https://github.com/kicad/kicad-source-mirror/blob/master/eeschema/symbol_library_manager.cpp): `eeschema/symbol_library_manager.cpp`
- [PCB editor](https://github.com/kicad/kicad-source-mirror/tree/master/pcbnew): `pcbnew`

### Design checks

- [Connectivity engine](https://github.com/kicad/kicad-source-mirror/blob/master/eeschema/connectivity/conn_engine.h): `eeschema/connectivity/conn_engine.h`
- [Schematic ERC](https://github.com/kicad/kicad-source-mirror/blob/master/eeschema/connectivity/conn_engine_erc.cpp): `eeschema/connectivity/conn_engine_erc.cpp`
- [PCB DRC](https://github.com/kicad/kicad-source-mirror/blob/master/pcbnew/drc/drc_engine.cpp): `pcbnew/drc/drc_engine.cpp`

### Visualization

- [Router preview](https://github.com/kicad/kicad-source-mirror/blob/master/pcbnew/router/router_preview_item.cpp): `pcbnew/router/router_preview_item.cpp`
- [3D viewer controls](https://github.com/kicad/kicad-source-mirror/blob/master/3d-viewer/3d_viewer/tools/eda_3d_controller.cpp): `3d-viewer/3d_viewer/tools/eda_3d_controller.cpp`
- [3D model cache](https://github.com/kicad/kicad-source-mirror/blob/master/3d-viewer/3d_cache/3d_plugin_manager.cpp): `3d-viewer/3d_cache/3d_plugin_manager.cpp`
- [3D rendering](https://github.com/kicad/kicad-source-mirror/tree/master/3d-viewer/3d_rendering): `3d-viewer/3d_rendering`
- [Bitmap converter](https://github.com/kicad/kicad-source-mirror/blob/master/bitmap2component/bitmap2component.cpp): `bitmap2component/bitmap2component.cpp`

### Shared services

- [Settings manager](https://github.com/kicad/kicad-source-mirror/blob/master/common/settings/settings_manager.cpp): `common/settings/settings_manager.cpp`
- [Library manager](https://github.com/kicad/kicad-source-mirror/blob/master/common/libraries/library_manager.cpp): `common/libraries/library_manager.cpp`

### Other components

- **Engineer**

## Connections

- Engineer → Project manager: uses
- Project manager → Project actions: dispatches
- Project manager → Package manager: references (evidence: `kicad/kicad_manager_frame.cpp`)
- Project actions → Package manager UI: opens (evidence: `kicad/tools/kicad_manager_control.cpp`)
- Package manager UI → Package manager: manages packages (evidence: `kicad/pcm/dialogs/dialog_pcm.h`)
- Schematic editor → Connectivity engine: uses (evidence: `eeschema/connectivity/conn_engine_erc.cpp`)
- Connectivity engine → Schematic ERC: supplies checks (evidence: `eeschema/connectivity/conn_engine_erc.cpp`)
- PCB editor → PCB DRC: runs checks
- PCB editor → Router preview: renders preview (evidence: `pcbnew/router/router_preview_item.cpp`)
- Engineer → Schematic editor: edits
- Engineer → PCB editor: edits
