# team-ape-rip/ape-hoi4-tool-studio architecture

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

- Interactive diagram: https://gitdiagram.com/team-ape-rip/ape-hoi4-tool-studio
- Repository: https://github.com/team-ape-rip/ape-hoi4-tool-studio

## Overview

APE HOI4 Tool Studio is a modular Windows desktop workbench for HOI4 creation workflows. Users enter through the desktop application, choose an internal or extensible tool, and receive local file-processing results; tools communicate through worker bridges and core logic. The repository also includes plugins for parsing and image-related capabilities, plus online account/update services. The README documents platform-level capabilities, while several plugin implementations are unsampled, so their internal flows are not expanded here.

Main entry points: [`src/MainWindow.cpp`](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/MainWindow.cpp) (Desktop App), [`src/ToolQmlHostController.cpp`](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ToolQmlHostController.cpp) (Tool Host), [`src/ToolManager.cpp`](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ToolManager.cpp) (Tool Loading), [`tools/FileManagerTool/main/FileManagerCore.cpp`](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/FileManagerTool/main/FileManagerCore.cpp) (File Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop Platform"]
  node_app["Desktop App<br/>[MainWindow.cpp]"]
  node_fileindex["File Index<br/>[FileManager.cpp]"]
  node_config["Configuration<br/>[ConfigManager.h]"]
  node_localization["Localization"]
end

subgraph group_ecosystem["Tool Ecosystem"]
  node_toolmanager["Tool Loading<br/>[ToolManager.cpp]"]
  node_toolhost["Tool Host"]
  node_filetool["File Manager"]
  node_flagtool["Flag Manager"]
  node_fonttool["Font Manager"]
  node_logtool["Log Manager<br/>[LogManagerCore.cpp]"]
end

subgraph group_plugins["Plugin Extensions"]
  node_tagplugin["Tag List<br/>[TagManager.cpp]"]
  node_parserplugin["HOI4 Parser<br/>[ParserSession.cpp]"]
  node_imageplugin["Image Tools<br/>[ImageProcessor.cpp]"]
  node_atlasplugin["Atlas Plugin"]
end

subgraph group_services["Online Services"]
  node_auth["Account Services<br/>[AuthManager.cpp]"]
  node_api["Remote API<br/>[ApiRequests.h]"]
  node_http["HTTP Client<br/>[HttpClient.h]"]
  node_updater["Update Service<br/>[Update.cpp]"]
end

node_user(("HOI4 Creator"))

node_user -->|"uses"| node_app
node_app -->|"loads tools"| node_toolmanager
node_toolmanager -.->|"hosts tools"| node_toolhost
node_toolhost -.->|"dispatches actions"| node_filetool
node_toolhost -.->|"dispatches actions"| node_flagtool
node_toolhost -.->|"dispatches actions"| node_fonttool
node_toolhost -.->|"dispatches actions"| node_logtool
node_filetool -.->|"uses files"| node_fileindex
node_tagplugin -->|"scans files"| node_fileindex
node_fonttool -.->|"uses atlas"| node_atlasplugin
node_app -->|"manages settings"| node_config
node_app -->|"localizes UI"| node_localization
node_app -->|"offers accounts"| node_auth
node_auth -->|"requests services"| node_api
node_api -->|"uses transport"| node_http
node_app -->|"provides updates"| node_updater

click node_app "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/MainWindow.cpp"
click node_fileindex "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/FileManager.cpp"
click node_config "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ConfigManager.h"
click node_localization "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/LocalizationManager.cpp"
click node_toolmanager "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ToolManager.cpp"
click node_toolhost "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ToolQmlHostController.cpp"
click node_filetool "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/FileManagerTool/main/FileManagerCore.cpp"
click node_flagtool "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/FlagManagerTool/main/FlagManagerCore.cpp"
click node_fonttool "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/FontManagerTool/main/FontManagerCore.cpp"
click node_logtool "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/LogManagerTool/main/LogManagerCore.cpp"
click node_tagplugin "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/TagList/main/TagManager.cpp"
click node_parserplugin "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/APEHOI4Parser/main/Core/ParserSession.cpp"
click node_imageplugin "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/Lumorpha/main/Processing/ImageProcessor.cpp"
click node_atlasplugin "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/DryadAtlas/DryadAtlasPluginExports.cpp"
click node_auth "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/AuthManager.cpp"
click node_api "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ApiRequests.h"
click node_http "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/HttpClient.h"
click node_updater "https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/Update.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_app,node_fileindex,node_config,node_localization toneBlue
class node_toolmanager,node_toolhost,node_filetool,node_flagtool,node_fonttool,node_logtool toneAmber
class node_tagplugin,node_parserplugin,node_imageplugin,node_atlasplugin toneMint
class node_auth,node_api,node_http,node_updater toneRose
class node_user toneIndigo
```

## Components

### Desktop Platform

- [Desktop App](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/MainWindow.cpp): `src/MainWindow.cpp`
- [File Index](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/FileManager.cpp): `src/FileManager.cpp`
- [Configuration](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ConfigManager.h): `src/ConfigManager.h`
- [Localization](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/LocalizationManager.cpp): `src/LocalizationManager.cpp`

### Tool Ecosystem

- [Tool Loading](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ToolManager.cpp): `src/ToolManager.cpp`
- [Tool Host](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ToolQmlHostController.cpp): `src/ToolQmlHostController.cpp`
- [File Manager](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/FileManagerTool/main/FileManagerCore.cpp): `tools/FileManagerTool/main/FileManagerCore.cpp`
- [Flag Manager](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/FlagManagerTool/main/FlagManagerCore.cpp): `tools/FlagManagerTool/main/FlagManagerCore.cpp`
- [Font Manager](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/FontManagerTool/main/FontManagerCore.cpp): `tools/FontManagerTool/main/FontManagerCore.cpp`
- [Log Manager](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/tools/LogManagerTool/main/LogManagerCore.cpp): `tools/LogManagerTool/main/LogManagerCore.cpp`

### Plugin Extensions

- [Tag List](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/TagList/main/TagManager.cpp): `plugins/TagList/main/TagManager.cpp`
- [HOI4 Parser](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/APEHOI4Parser/main/Core/ParserSession.cpp): `plugins/APEHOI4Parser/main/Core/ParserSession.cpp`
- [Image Tools](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/Lumorpha/main/Processing/ImageProcessor.cpp): `plugins/Lumorpha/main/Processing/ImageProcessor.cpp`
- [Atlas Plugin](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/plugins/DryadAtlas/DryadAtlasPluginExports.cpp): `plugins/DryadAtlas/DryadAtlasPluginExports.cpp`

### Online Services

- [Account Services](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/AuthManager.cpp): `src/AuthManager.cpp`
- [Remote API](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/ApiRequests.h): `src/ApiRequests.h`
- [HTTP Client](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/HttpClient.h): `src/HttpClient.h`
- [Update Service](https://github.com/team-ape-rip/ape-hoi4-tool-studio/blob/main/src/Update.cpp): `src/Update.cpp`

### Other components

- **HOI4 Creator**

## Connections

- HOI4 Creator → Desktop App: uses (evidence: `README.md`)
- Desktop App → Tool Loading: loads tools (evidence: `README.md`)
- Tool Loading → Tool Host: hosts tools
- Tool Host → File Manager: dispatches actions
- Tool Host → Flag Manager: dispatches actions
- Tool Host → Font Manager: dispatches actions
- Tool Host → Log Manager: dispatches actions
- File Manager → File Index: uses files
- Tag List → File Index: scans files (evidence: `plugins/TagList/main/TagManager.cpp`)
- Font Manager → Atlas Plugin: uses atlas
- Desktop App → Configuration: manages settings (evidence: `README.md`)
- Desktop App → Localization: localizes UI (evidence: `README.md`)
- Desktop App → Account Services: offers accounts (evidence: `README.md`)
- Account Services → Remote API: requests services (evidence: `src/AuthManager.cpp`)
- Remote API → HTTP Client: uses transport (evidence: `src/ApiRequests.h`)
- Desktop App → Update Service: provides updates (evidence: `README.md`)
