# community-outpost/genhub architecture

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

- Interactive diagram: https://gitdiagram.com/community-outpost/genhub
- Repository: https://github.com/community-outpost/genhub

## Overview

GenHub is a cross-platform Command & Conquer: Generals and Zero Hour launcher and workspace manager. Its principal workflow is to discover community content, install and maintain it in isolated workspaces, then launch a selected game client; the README also highlights map/replay management, platform support, and application updates. The graph retains the central manifest/CAS storage layer and storage migration. Some feature implementations are represented by their exact directories because only the README or tree establishes their presence; those links are documented capability relationships, not claims of inspected calls.

Main entry points: [`GenHub/GenHub.Windows/Program.cs`](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Windows/Program.cs) (GenHub launcher), [`GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs`](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs) (Catalog ingestion), [`GenHub/GenHub/Features/Content/Services`](https://github.com/community-outpost/genhub/tree/development/GenHub/GenHub/Features/Content/Services) (Content discovery), [`GenHub/GenHub.Core/Models/Manifest/ContentManifest.cs`](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Manifest/ContentManifest.cs) (Content manifests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content discovery and install"]
  node_catalog["Catalog ingestion"]
  node_discovery["Content discovery"]
  node_contenttypes["Content types<br/>[ContentType.cs]"]
  node_manifest["Content manifests<br/>[ContentManifest.cs]"]
  node_catalogconstants["Catalog constants"]
  node_manifestconstants["Manifest constants"]
  node_manifestfile["Manifest files<br/>[ManifestFile.cs]"]
  node_manifestid["Manifest identity<br/>[ManifestId.cs]"]
  node_operationresult["Operation results<br/>[OperationResult.cs]"]
end

subgraph group_workspace["Workspace and storage"]
  node_contentstorage["Content storage"]
  node_cas[("CAS storage<br/>[CasStorage.cs]")]
  node_workspacefiles["Workspace files"]
  node_migration["Storage migration"]
  node_config["Configuration"]
  node_directories["Directory names<br/>[DirectoryNames.cs]"]
  node_pathhelper["Path helper<br/>[PathHelper.cs]"]
  node_settings["User settings<br/>[UserSettings.cs]"]
  node_casconfig["CAS configuration"]
end

subgraph group_game["Game profiles and launch"]
  node_profiles["Game profiles"]
  node_clients["Game clients<br/>[GameClient.cs]"]
  node_process["Game process manager"]
end

subgraph group_features["Maps and community tools"]
  node_mapsreplays["Map and replay manager"]
  node_modbuilder["Mod builder"]
end

subgraph group_platform["Platform and updates"]
  node_app["GenHub launcher<br/>[Program.cs]"]
  node_platforms["Platform services"]
  node_updates["Application updates"]
  node_appconstants["App constants<br/>[AppConstants.cs]"]
end

node_user(("Player"))
node_github["GitHub releases"]

node_user -->|"uses"| node_app
node_app -.->|"discovers content"| node_catalog
node_catalog -->|"fetches releases"| node_github
node_catalog -->|"dispatches discovery"| node_discovery
node_discovery -.->|"classifies content"| node_contenttypes
node_app -.->|"installs content"| node_manifest
node_manifest -.->|"stores content"| node_contentstorage
node_contentstorage -.->|"uses CAS"| node_cas
node_app -->|"manages workspaces"| node_workspacefiles
node_app -.->|"migrates storage"| node_migration
node_migration -->|"reads settings"| node_config
node_app -->|"manages profiles"| node_profiles
node_profiles -.->|"selects client"| node_clients
node_app -->|"launches game"| node_process
node_app -->|"manages maps and replays"| node_mapsreplays
node_app -.->|"builds mods"| node_modbuilder
node_app -->|"runs across platforms"| node_platforms
node_app -->|"updates application"| node_updates

click node_app "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Windows/Program.cs"
click node_catalog "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs"
click node_discovery "https://github.com/community-outpost/genhub/tree/development/GenHub/GenHub/Features/Content/Services"
click node_contenttypes "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Enums/ContentType.cs"
click node_manifest "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Manifest/ContentManifest.cs"
click node_contentstorage "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Content/Services/ContentStorageService.cs"
click node_cas "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Storage/Services/CasStorage.cs"
click node_workspacefiles "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Workspace/FileOperationsService.cs"
click node_migration "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Common/Services/StorageMigrationService.cs"
click node_config "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Interfaces/Common/IConfigurationProviderService.cs"
click node_profiles "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Interfaces/GameProfiles/IGameProfileManager.cs"
click node_clients "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/GameClients/GameClient.cs"
click node_process "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/GameProfiles/Infrastructure/GameProcessManager.cs"
click node_mapsreplays "https://github.com/community-outpost/genhub/tree/development/GenHub/GenHub/Features"
click node_modbuilder "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Tools/ModBuilder/Services/BuildEngineService.cs"
click node_platforms "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Windows/Infrastructure/DependencyInjection/WindowsServicesModule.cs"
click node_updates "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/AppUpdateConstants.cs"
click node_appconstants "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/AppConstants.cs"
click node_catalogconstants "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/CatalogConstants.cs"
click node_directories "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/DirectoryNames.cs"
click node_manifestconstants "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/ManifestConstants.cs"
click node_pathhelper "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Helpers/PathHelper.cs"
click node_settings "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Common/UserSettings.cs"
click node_manifestfile "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Manifest/ManifestFile.cs"
click node_manifestid "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Manifest/ManifestId.cs"
click node_operationresult "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Results/OperationResult.cs"
click node_casconfig "https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Storage/CasConfiguration.cs"

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_catalog,node_discovery,node_contenttypes,node_manifest,node_catalogconstants,node_manifestconstants,node_manifestfile,node_manifestid,node_operationresult toneBlue
class node_contentstorage,node_cas,node_workspacefiles,node_migration,node_config,node_directories,node_pathhelper,node_settings,node_casconfig toneAmber
class node_profiles,node_clients,node_process toneMint
class node_mapsreplays,node_modbuilder toneRose
class node_app,node_platforms,node_updates,node_appconstants,node_user,node_github toneIndigo
```

## Components

### Content discovery and install

- [Catalog ingestion](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs): `GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs`
- [Content discovery](https://github.com/community-outpost/genhub/tree/development/GenHub/GenHub/Features/Content/Services): `GenHub/GenHub/Features/Content/Services`
- [Content types](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Enums/ContentType.cs): `GenHub/GenHub.Core/Models/Enums/ContentType.cs`
- [Content manifests](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Manifest/ContentManifest.cs): `GenHub/GenHub.Core/Models/Manifest/ContentManifest.cs`
- [Catalog constants](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/CatalogConstants.cs): `GenHub/GenHub.Core/Constants/CatalogConstants.cs`
- [Manifest constants](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/ManifestConstants.cs): `GenHub/GenHub.Core/Constants/ManifestConstants.cs`
- [Manifest files](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Manifest/ManifestFile.cs): `GenHub/GenHub.Core/Models/Manifest/ManifestFile.cs`
- [Manifest identity](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Manifest/ManifestId.cs): `GenHub/GenHub.Core/Models/Manifest/ManifestId.cs`
- [Operation results](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Results/OperationResult.cs): `GenHub/GenHub.Core/Models/Results/OperationResult.cs`

### Workspace and storage

- [Content storage](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Content/Services/ContentStorageService.cs): `GenHub/GenHub/Features/Content/Services/ContentStorageService.cs`
- [CAS storage](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Storage/Services/CasStorage.cs): `GenHub/GenHub/Features/Storage/Services/CasStorage.cs`
- [Workspace files](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Workspace/FileOperationsService.cs): `GenHub/GenHub/Features/Workspace/FileOperationsService.cs`
- [Storage migration](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Common/Services/StorageMigrationService.cs): `GenHub/GenHub/Common/Services/StorageMigrationService.cs`
- [Configuration](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Interfaces/Common/IConfigurationProviderService.cs): `GenHub/GenHub.Core/Interfaces/Common/IConfigurationProviderService.cs`
- [Directory names](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/DirectoryNames.cs): `GenHub/GenHub.Core/Constants/DirectoryNames.cs`
- [Path helper](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Helpers/PathHelper.cs): `GenHub/GenHub.Core/Helpers/PathHelper.cs`
- [User settings](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Common/UserSettings.cs): `GenHub/GenHub.Core/Models/Common/UserSettings.cs`
- [CAS configuration](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/Storage/CasConfiguration.cs): `GenHub/GenHub.Core/Models/Storage/CasConfiguration.cs`

### Game profiles and launch

- [Game profiles](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Interfaces/GameProfiles/IGameProfileManager.cs): `GenHub/GenHub.Core/Interfaces/GameProfiles/IGameProfileManager.cs`
- [Game clients](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Models/GameClients/GameClient.cs): `GenHub/GenHub.Core/Models/GameClients/GameClient.cs`
- [Game process manager](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/GameProfiles/Infrastructure/GameProcessManager.cs): `GenHub/GenHub/Features/GameProfiles/Infrastructure/GameProcessManager.cs`

### Maps and community tools

- [Map and replay manager](https://github.com/community-outpost/genhub/tree/development/GenHub/GenHub/Features): `GenHub/GenHub/Features`
- [Mod builder](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub/Features/Tools/ModBuilder/Services/BuildEngineService.cs): `GenHub/GenHub/Features/Tools/ModBuilder/Services/BuildEngineService.cs`

### Platform and updates

- [GenHub launcher](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Windows/Program.cs): `GenHub/GenHub.Windows/Program.cs`
- [Platform services](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Windows/Infrastructure/DependencyInjection/WindowsServicesModule.cs): `GenHub/GenHub.Windows/Infrastructure/DependencyInjection/WindowsServicesModule.cs`
- [Application updates](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/AppUpdateConstants.cs): `GenHub/GenHub.Core/Constants/AppUpdateConstants.cs`
- [App constants](https://github.com/community-outpost/genhub/blob/development/GenHub/GenHub.Core/Constants/AppConstants.cs): `GenHub/GenHub.Core/Constants/AppConstants.cs`

### Other components

- **Player**
- **GitHub releases**

## Connections

- Player → GenHub launcher: uses (evidence: `README.md`)
- GenHub launcher → Catalog ingestion: discovers content
- Catalog ingestion → GitHub releases: fetches releases (evidence: `GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs`)
- Catalog ingestion → Content discovery: dispatches discovery (evidence: `GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs`)
- Content discovery → Content types: classifies content (evidence: `GenHub/GenHub/Features/Content/Services/Catalog/CatalogUpstreamIngestionService.cs`)
- GenHub launcher → Content manifests: installs content
- Content manifests → Content storage: stores content (evidence: `GenHub/GenHub/Features/Content/Services/ContentStorageService.cs`)
- Content storage → CAS storage: uses CAS
- GenHub launcher → Workspace files: manages workspaces (evidence: `README.md`)
- GenHub launcher → Storage migration: migrates storage
- Storage migration → Configuration: reads settings (evidence: `GenHub/GenHub/Common/Services/StorageMigrationService.cs`)
- GenHub launcher → Game profiles: manages profiles (evidence: `README.md`)
- Game profiles → Game clients: selects client
- GenHub launcher → Game process manager: launches game (evidence: `README.md`)
- GenHub launcher → Map and replay manager: manages maps and replays (evidence: `README.md`)
- GenHub launcher → Mod builder: builds mods
- GenHub launcher → Platform services: runs across platforms (evidence: `README.md`)
- GenHub launcher → Application updates: updates application (evidence: `README.md`)
