# dota2modmanager/dota2-mod-manager architecture

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

- Interactive diagram: https://gitdiagram.com/dota2modmanager/dota2-mod-manager
- Repository: https://github.com/dota2modmanager/dota2-mod-manager

## Overview

Dota 2 Mod Manager is a desktop app for finding, installing, organizing, and sharing client-side Dota 2 mods. The main user workflow is browse the live catalog, choose mods, install them into managed pak slots, then enable, disable, or reorder them in the library. Separate product stages cover cosmetic item previews and building, preset sharing, importing/adopting files, and repairing installs after game patches. The renderer and Electron main process communicate through app APIs and IPC; source excerpts show startup and renderer orchestration, but not every bridge or service call.

Main entry points: [`renderer/views/catalog.ts`](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/catalog.ts) (Catalog screen), [`renderer/app.ts`](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/app.ts) (Window startup), [`src/installer.ts`](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/installer.ts) (Mod installer), [`src/services.ts`](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/services.ts) (Service composition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_renderer["Renderer experience"]
  node_renderer_app["Window startup<br/>[app.ts]"]
  node_router["Screen router<br/>[router.ts]"]
  node_shared_state["Shared state<br/>[store.ts]"]
  node_renderer_api["Window API<br/>[app.ts]"]
end

subgraph group_catalog["Catalog and cosmetics"]
  node_catalog_view["Catalog screen<br/>[catalog.ts]"]
  node_catalog_data["Catalog data<br/>[data.ts]"]
  node_cosmetics["Cosmetics and builder<br/>[item-builder.ts]"]
end

subgraph group_install["Mod management"]
  node_library_view["Library screen<br/>[library.ts]"]
  node_installed_index["Installed index<br/>[installed.ts]"]
end

subgraph group_main["Desktop services"]
  node_installer["Mod installer<br/>[installer.ts]"]
  node_library_service[("Library service<br/>[library.ts]")]
  node_services["Service composition<br/>[services.ts]"]
  node_main_process["Electron startup<br/>[main.ts]"]
  node_ipc["IPC handlers<br/>[ipc.ts]"]
end

subgraph group_share["Presets and upkeep"]
  node_preset_ui["Preset screen<br/>[presets.ts]"]
  node_preset_service["Preset service<br/>[presets-service.ts]"]
  node_patch_repair["Patch repair<br/>[game-upkeep.ts]"]
  node_import_adopt["Import and adoption<br/>[import.ts]"]
end

node_user(("Player"))
node_external_catalog[("D2PFX catalog")]
node_game["Dota 2 files"]

node_user -->|"uses"| node_renderer_app
node_renderer_app -->|"boots screens"| node_router
node_renderer_app -->|"loads catalog"| node_catalog_view
node_catalog_view -->|"registers screen"| node_router
node_catalog_view -->|"reads state"| node_shared_state
node_catalog_view -->|"renders catalog"| node_catalog_data
node_external_catalog -->|"supplies live catalog"| node_catalog_data
node_user -->|"browses mods"| node_catalog_view
node_user -->|"builds item looks"| node_cosmetics
node_renderer_app -->|"refreshes installs"| node_installed_index
node_installed_index -->|"indexes records"| node_shared_state
node_user -->|"manages mods"| node_library_view
node_library_view -.->|"uses install index"| node_installed_index
node_main_process -->|"creates services"| node_services
node_services -->|"creates installer"| node_installer
node_services -->|"creates library"| node_library_service
node_main_process -.->|"registers handlers"| node_ipc
node_renderer_api -.->|"invokes channels"| node_ipc
node_installer -->|"writes pak slots"| node_game
node_installer -.->|"records installs"| node_library_service
node_user -->|"shares setup"| node_preset_ui
node_preset_ui -.->|"uses preset actions"| node_preset_service
node_preset_service -->|"records shared preset"| node_library_service
node_user -->|"imports files"| node_import_adopt
node_import_adopt -->|"registers imported mods"| node_installer
node_game -->|"patch triggers repair"| node_patch_repair
node_patch_repair -->|"restores install"| node_game

click node_renderer_app "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/app.ts"
click node_router "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/core/router.ts"
click node_shared_state "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/core/store.ts"
click node_renderer_api "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/api/app.ts"
click node_catalog_view "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/catalog.ts"
click node_catalog_data "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/catalog/data.ts"
click node_cosmetics "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/item-builder.ts"
click node_library_view "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/library.ts"
click node_installed_index "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/core/installed.ts"
click node_installer "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/installer.ts"
click node_library_service "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/library.ts"
click node_services "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/services.ts"
click node_main_process "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/main.ts"
click node_ipc "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/ipc.ts"
click node_preset_ui "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/presets.ts"
click node_preset_service "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/presets-service.ts"
click node_patch_repair "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/game-upkeep.ts"
click node_import_adopt "https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/import.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_renderer_app,node_router,node_shared_state,node_renderer_api toneBlue
class node_catalog_view,node_catalog_data,node_cosmetics,node_external_catalog toneAmber
class node_library_view,node_installed_index toneMint
class node_installer,node_library_service,node_services,node_main_process,node_ipc toneRose
class node_preset_ui,node_preset_service,node_patch_repair,node_import_adopt,node_user,node_game toneIndigo
```

## Components

### Renderer experience

- [Window startup](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/app.ts): `renderer/app.ts`
- [Screen router](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/core/router.ts): `renderer/core/router.ts`
- [Shared state](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/core/store.ts): `renderer/core/store.ts`
- [Window API](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/api/app.ts): `renderer/api/app.ts`

### Catalog and cosmetics

- [Catalog screen](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/catalog.ts): `renderer/views/catalog.ts`
- [Catalog data](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/catalog/data.ts): `renderer/catalog/data.ts`
- [Cosmetics and builder](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/item-builder.ts): `renderer/views/item-builder.ts`

### Mod management

- [Library screen](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/library.ts): `renderer/views/library.ts`
- [Installed index](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/core/installed.ts): `renderer/core/installed.ts`

### Desktop services

- [Mod installer](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/installer.ts): `src/installer.ts`
- [Library service](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/library.ts): `src/library.ts`
- [Service composition](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/services.ts): `src/services.ts`
- [Electron startup](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/main.ts): `src/main.ts`
- [IPC handlers](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/ipc.ts): `src/ipc.ts`

### Presets and upkeep

- [Preset screen](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/renderer/views/presets.ts): `renderer/views/presets.ts`
- [Preset service](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/presets-service.ts): `src/presets-service.ts`
- [Patch repair](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/game-upkeep.ts): `src/game-upkeep.ts`
- [Import and adoption](https://github.com/dota2modmanager/dota2-mod-manager/blob/main/src/import.ts): `src/import.ts`

### Other components

- **Player**
- **D2PFX catalog**
- **Dota 2 files**

## Connections

- Player → Window startup: uses (evidence: `README.md`)
- Window startup → Screen router: boots screens (evidence: `renderer/app.ts`)
- Window startup → Catalog screen: loads catalog (evidence: `renderer/app.ts`)
- Catalog screen → Screen router: registers screen (evidence: `renderer/views/catalog.ts`)
- Catalog screen → Shared state: reads state (evidence: `renderer/views/catalog.ts`)
- Catalog screen → Catalog data: renders catalog (evidence: `renderer/views/catalog.ts`)
- D2PFX catalog → Catalog data: supplies live catalog (evidence: `README.md`)
- Player → Catalog screen: browses mods (evidence: `README.md`)
- Player → Cosmetics and builder: builds item looks (evidence: `README.md`)
- Window startup → Installed index: refreshes installs (evidence: `renderer/app.ts`)
- Installed index → Shared state: indexes records (evidence: `renderer/core/installed.ts`)
- Player → Library screen: manages mods (evidence: `README.md`)
- Library screen → Installed index: uses install index
- Electron startup → Service composition: creates services (evidence: `src/main.ts`)
- Service composition → Mod installer: creates installer (evidence: `src/services.ts`)
- Service composition → Library service: creates library (evidence: `src/services.ts`)
- Electron startup → IPC handlers: registers handlers (evidence: `src/main.ts`)
- Window API → IPC handlers: invokes channels
- Mod installer → Dota 2 files: writes pak slots (evidence: `README.md`)
- Mod installer → Library service: records installs
- Player → Preset screen: shares setup (evidence: `README.md`)
- Preset screen → Preset service: uses preset actions
- Preset service → Library service: records shared preset (evidence: `src/presets-service.ts`)
- Player → Import and adoption: imports files (evidence: `README.md`)
- Import and adoption → Mod installer: registers imported mods (evidence: `src/services.ts`)
- Dota 2 files → Patch repair: patch triggers repair (evidence: `README.md`)
- Patch repair → Dota 2 files: restores install (evidence: `README.md`)
