# orgolis/worldshaper-hub architecture

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

- Interactive diagram: https://gitdiagram.com/orgolis/worldshaper-hub
- Repository: https://github.com/orgolis/worldshaper-hub

## Overview

GameWorldshaper Hub is a standalone launcher for projects and multiple engine versions. The user-facing workflow runs through the GUI: create or import a project, bind it to an engine version, then open it in that version’s editor. Users can also discover, install, update, and remove engines, and update the Hub itself. Project scaffolding, release retrieval, package installation, and self-update are distinct domain stages. Edges reflect README claims and source-index references; some UI implementation details are unsampled, so those links are limited to documented behavior.

Main entry points: [`src/main.cpp`](https://github.com/orgolis/worldshaper-hub/blob/main/src/main.cpp) (Hub GUI), [`src/self_update.cpp`](https://github.com/orgolis/worldshaper-hub/blob/main/src/self_update.cpp) (Hub Self-Update), [`src/github_releases.cpp`](https://github.com/orgolis/worldshaper-hub/blob/main/src/github_releases.cpp) (GitHub Releases), [`src/update_feed.cpp`](https://github.com/orgolis/worldshaper-hub/blob/main/src/update_feed.cpp) (Package Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_project["Projects"]
  node_project_model["Project Model<br/>[project.cpp]"]
  node_project_manifest["Project Manifest<br/>[project.h]"]
  node_project_features["Project Features<br/>[project_features.h]"]
  node_recent_projects[("Recent Projects<br/>[project.cpp]")]
  node_git_scaffold["Git Scaffolding<br/>[git_scaffold.cpp]"]
end

subgraph group_engines["Engine Versions"]
  node_engine_registry[("Engine Registry")]
  node_editor_launch["Editor Launch"]
  node_version_compare["Version Comparison<br/>[version_compare.h]"]
end

subgraph group_remote["Remote Updates"]
  node_release_source["GitHub Releases"]
  node_http_client["HTTP Client<br/>[http_client.cpp]"]
  node_feed_installer["Package Installer<br/>[update_feed.cpp]"]
  node_update_feed["Generic Update Feed<br/>[update_feed.cpp]"]
end

subgraph group_hub["Hub Application"]
  node_gui["Hub GUI<br/>[main.cpp]"]
  node_self_update["Hub Self-Update<br/>[self_update.cpp]"]
  node_hub_config[("Hub Settings<br/>[main.cpp]")]
end

node_user(("User"))
node_github(("GitHub"))

node_user -->|"uses"| node_gui
node_gui -->|"creates or imports"| node_project_model
node_project_model -->|"reads and writes"| node_project_manifest
node_project_model -->|"uses features"| node_project_features
node_gui -->|"manages"| node_recent_projects
node_gui -->|"scaffolds projects"| node_git_scaffold
node_gui -->|"manages versions"| node_engine_registry
node_gui -->|"opens project"| node_editor_launch
node_engine_registry -->|"compares versions"| node_version_compare
node_gui -->|"checks releases"| node_release_source
node_release_source -->|"queries releases"| node_github
node_release_source -->|"requests API"| node_http_client
node_gui -->|"installs package"| node_feed_installer
node_release_source -->|"provides package"| node_feed_installer
node_feed_installer -->|"downloads package"| node_http_client
node_feed_installer -->|"installs engine"| node_engine_registry
node_gui -->|"configures feed"| node_update_feed
node_gui -->|"checks and applies"| node_self_update
node_self_update -->|"checks Hub releases"| node_release_source
node_self_update -->|"downloads update"| node_http_client
node_self_update -->|"extracts package"| node_update_feed
node_self_update -->|"compares versions"| node_version_compare
node_gui -->|"manages settings"| node_hub_config
node_gui -->|"removes installed engine"| node_engine_registry
node_gui -->|"uninstalls Hub"| node_self_update

click node_gui "https://github.com/orgolis/worldshaper-hub/blob/main/src/main.cpp"
click node_project_model "https://github.com/orgolis/worldshaper-hub/blob/main/src/project.cpp"
click node_project_manifest "https://github.com/orgolis/worldshaper-hub/blob/main/src/project.h"
click node_project_features "https://github.com/orgolis/worldshaper-hub/blob/main/src/project_features.h"
click node_recent_projects "https://github.com/orgolis/worldshaper-hub/blob/main/src/project.cpp"
click node_git_scaffold "https://github.com/orgolis/worldshaper-hub/blob/main/src/git_scaffold.cpp"
click node_engine_registry "https://github.com/orgolis/worldshaper-hub/blob/main/src/engine_registry.cpp"
click node_editor_launch "https://github.com/orgolis/worldshaper-hub/blob/main/src/engine_registry.cpp"
click node_version_compare "https://github.com/orgolis/worldshaper-hub/blob/main/src/version_compare.h"
click node_release_source "https://github.com/orgolis/worldshaper-hub/blob/main/src/github_releases.cpp"
click node_http_client "https://github.com/orgolis/worldshaper-hub/blob/main/src/http_client.cpp"
click node_feed_installer "https://github.com/orgolis/worldshaper-hub/blob/main/src/update_feed.cpp"
click node_update_feed "https://github.com/orgolis/worldshaper-hub/blob/main/src/update_feed.cpp"
click node_self_update "https://github.com/orgolis/worldshaper-hub/blob/main/src/self_update.cpp"
click node_hub_config "https://github.com/orgolis/worldshaper-hub/blob/main/src/main.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_model,node_project_manifest,node_project_features,node_recent_projects,node_git_scaffold,node_user toneBlue
class node_engine_registry,node_editor_launch,node_version_compare toneAmber
class node_release_source,node_http_client,node_feed_installer,node_update_feed toneMint
class node_gui,node_self_update,node_hub_config toneRose
class node_github toneIndigo
```

## Components

### Projects

- [Project Model](https://github.com/orgolis/worldshaper-hub/blob/main/src/project.cpp): `src/project.cpp`
- [Project Manifest](https://github.com/orgolis/worldshaper-hub/blob/main/src/project.h): `src/project.h`
- [Project Features](https://github.com/orgolis/worldshaper-hub/blob/main/src/project_features.h): `src/project_features.h`
- [Recent Projects](https://github.com/orgolis/worldshaper-hub/blob/main/src/project.cpp): `src/project.cpp`
- [Git Scaffolding](https://github.com/orgolis/worldshaper-hub/blob/main/src/git_scaffold.cpp): `src/git_scaffold.cpp`

### Engine Versions

- [Engine Registry](https://github.com/orgolis/worldshaper-hub/blob/main/src/engine_registry.cpp): `src/engine_registry.cpp`
- [Editor Launch](https://github.com/orgolis/worldshaper-hub/blob/main/src/engine_registry.cpp): `src/engine_registry.cpp`
- [Version Comparison](https://github.com/orgolis/worldshaper-hub/blob/main/src/version_compare.h): `src/version_compare.h`

### Remote Updates

- [GitHub Releases](https://github.com/orgolis/worldshaper-hub/blob/main/src/github_releases.cpp): `src/github_releases.cpp`
- [HTTP Client](https://github.com/orgolis/worldshaper-hub/blob/main/src/http_client.cpp): `src/http_client.cpp`
- [Package Installer](https://github.com/orgolis/worldshaper-hub/blob/main/src/update_feed.cpp): `src/update_feed.cpp`
- [Generic Update Feed](https://github.com/orgolis/worldshaper-hub/blob/main/src/update_feed.cpp): `src/update_feed.cpp`

### Hub Application

- [Hub GUI](https://github.com/orgolis/worldshaper-hub/blob/main/src/main.cpp): `src/main.cpp`
- [Hub Self-Update](https://github.com/orgolis/worldshaper-hub/blob/main/src/self_update.cpp): `src/self_update.cpp`
- [Hub Settings](https://github.com/orgolis/worldshaper-hub/blob/main/src/main.cpp): `src/main.cpp`

### Other components

- **User**
- **GitHub**

## Connections

- User → Hub GUI: uses (evidence: `README.md`)
- Hub GUI → Project Model: creates or imports (evidence: `src/main.cpp`)
- Project Model → Project Manifest: reads and writes (evidence: `README.md`)
- Project Model → Project Features: uses features
- Hub GUI → Recent Projects: manages (evidence: `src/main.cpp`)
- Hub GUI → Git Scaffolding: scaffolds projects
- Hub GUI → Engine Registry: manages versions (evidence: `src/main.cpp`)
- Hub GUI → Editor Launch: opens project (evidence: `README.md`)
- Engine Registry → Version Comparison: compares versions (evidence: `src/engine_registry.cpp`)
- Hub GUI → GitHub Releases: checks releases (evidence: `src/main.cpp`)
- GitHub Releases → GitHub: queries releases (evidence: `README.md`)
- GitHub Releases → HTTP Client: requests API (evidence: `src/github_releases.cpp`)
- Hub GUI → Package Installer: installs package (evidence: `src/main.cpp`)
- GitHub Releases → Package Installer: provides package
- Package Installer → HTTP Client: downloads package
- Package Installer → Engine Registry: installs engine (evidence: `src/update_feed.cpp`)
- Hub GUI → Generic Update Feed: configures feed (evidence: `src/main.cpp`)
- Hub GUI → Hub Self-Update: checks and applies (evidence: `src/main.cpp`)
- Hub Self-Update → GitHub Releases: checks Hub releases (evidence: `src/self_update.cpp`)
- Hub Self-Update → HTTP Client: downloads update (evidence: `src/self_update.cpp`)
- Hub Self-Update → Generic Update Feed: extracts package (evidence: `src/self_update.cpp`)
- Hub Self-Update → Version Comparison: compares versions (evidence: `src/self_update.cpp`)
- Hub GUI → Hub Settings: manages settings (evidence: `README.md`)
- Hub GUI → Engine Registry: removes installed engine (evidence: `README.md`)
- Hub GUI → Hub Self-Update: uninstalls Hub (evidence: `README.md`)
