# thattanishqtak/trinity architecture

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

- Interactive diagram: https://gitdiagram.com/thattanishqtak/trinity
- Repository: https://github.com/thattanishqtak/trinity

## Overview

Trinity is presented in the README as a C++ game-engine scaffold with an editor, project/version hub, and sandbox; the source tree also contains substantial scene, asset, audio, scripting, physics, UI, and rendering subsystems. The principal documented workflow is a user opening a project through Hub into Forge, or running an application built on the engine. The README’s “renderer not written yet” description conflicts with the renderer implementation files in the tree, so the graph reflects the source layout without asserting rendering behavior. Arrows are limited to README statements or indexed source references; unsampled subsystem wiring is left unclaimed.

Main entry points: [`Trinity-Engine/Source/Trinity/Core/Application.cpp`](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Core/Application.cpp) (Application Loop), [`Trinity-Engine/Source/Trinity/Scene/SceneManager.cpp`](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Scene/SceneManager.cpp) (Scene Manager), [`Trinity-Hub/Source/HubLayer.cpp`](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Hub/Source/HubLayer.cpp) (Project Hub), [`Trinity-Forge/Source/EditorSession.cpp`](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Forge/Source/EditorSession.cpp) (Forge Editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Applications"]
  node_hub["Project Hub<br/>[HubLayer.cpp]"]
  node_forge["Forge Editor<br/>[EditorSession.cpp]"]
  node_sandbox["Sandbox<br/>[SandboxLayer.cpp]"]
end

subgraph group_runtime["Engine Runtime"]
  node_application["Application Loop<br/>[Application.cpp]"]
  node_window["Window Platform<br/>[Window.cpp]"]
  node_renderer["Renderer<br/>[Renderer.cpp]"]
  node_rhi["Graphics Devices<br/>[Device.cpp]"]
end

subgraph group_content["Content Systems"]
  node_scene["Scene Runtime<br/>[SceneRuntime.cpp]"]
  node_scene_manager["Scene Manager<br/>[SceneManager.cpp]"]
  node_serialization["Scene Serialization"]
  node_assets["Asset Manager<br/>[AssetManager.cpp]"]
end

subgraph group_services["Engine Services"]
  node_filesystem["File System<br/>[FileSystem.cpp]"]
  node_audio["Audio Engine<br/>[AudioEngine.cpp]"]
  node_physics["Physics Worlds<br/>[PhysicsWorld3D.cpp]"]
  node_scripting["Script Runtime<br/>[ScriptRuntime.cpp]"]
  node_script_api["C&#35; Script API<br/>[Entity.cs]"]
  node_game_ui["Game UI<br/>[GameUI.cpp]"]
  node_manifest["Engine Manifest<br/>[EngineManifest.cpp]"]
end

node_user(("User"))

node_user -->|"opens project"| node_hub
node_hub -->|"starts Forge"| node_forge
node_forge -->|"links engine"| node_application
node_sandbox -->|"links engine"| node_application
node_application -->|"uses audio"| node_audio
node_application -->|"uses renderer"| node_renderer
node_application -->|"uses device"| node_rhi
node_application -->|"uses UI"| node_game_ui
node_application -->|"initializes assets"| node_assets
node_application -->|"uses filesystem"| node_filesystem
node_scene_manager -->|"loads assets"| node_assets
node_scene_manager -.->|"runs scenes"| node_scene
node_scene_manager -->|"reads files"| node_filesystem
node_script_api -->|"calls native API"| node_scripting
node_user -->|"edits project"| node_forge
node_hub -->|"reads version info"| node_manifest

click node_hub "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Hub/Source/HubLayer.cpp"
click node_forge "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Forge/Source/EditorSession.cpp"
click node_sandbox "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Sandbox/Source/SandboxLayer.cpp"
click node_application "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Core/Application.cpp"
click node_window "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Core/Window.cpp"
click node_renderer "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Renderer/Renderer.cpp"
click node_rhi "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/RHI/Device.cpp"
click node_scene "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Scene/SceneRuntime.cpp"
click node_scene_manager "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Scene/SceneManager.cpp"
click node_serialization "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Include/Trinity/Scene/SceneSerializer.hpp"
click node_assets "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Asset/AssetManager.cpp"
click node_filesystem "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/FileSystem/FileSystem.cpp"
click node_audio "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Audio/AudioEngine.cpp"
click node_physics "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Physics/PhysicsWorld3D.cpp"
click node_scripting "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Scripting/ScriptRuntime.cpp"
click node_script_api "https://github.com/thattanishqtak/trinity/blob/main/Trinity-ScriptCore/Source/Types/Entity.cs"
click node_game_ui "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/UI/GameUI.cpp"
click node_manifest "https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Project/EngineManifest.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_hub,node_forge,node_sandbox,node_user toneBlue
class node_application,node_window,node_renderer,node_rhi toneAmber
class node_scene,node_scene_manager,node_serialization,node_assets toneMint
class node_filesystem,node_audio,node_physics,node_scripting,node_script_api,node_game_ui,node_manifest toneRose
```

## Components

### Applications

- [Project Hub](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Hub/Source/HubLayer.cpp): `Trinity-Hub/Source/HubLayer.cpp`
- [Forge Editor](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Forge/Source/EditorSession.cpp): `Trinity-Forge/Source/EditorSession.cpp`
- [Sandbox](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Sandbox/Source/SandboxLayer.cpp): `Trinity-Sandbox/Source/SandboxLayer.cpp`

### Engine Runtime

- [Application Loop](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Core/Application.cpp): `Trinity-Engine/Source/Trinity/Core/Application.cpp`
- [Window Platform](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Core/Window.cpp): `Trinity-Engine/Source/Trinity/Core/Window.cpp`
- [Renderer](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Renderer/Renderer.cpp): `Trinity-Engine/Source/Trinity/Renderer/Renderer.cpp`
- [Graphics Devices](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/RHI/Device.cpp): `Trinity-Engine/Source/Trinity/RHI/Device.cpp`

### Content Systems

- [Scene Runtime](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Scene/SceneRuntime.cpp): `Trinity-Engine/Source/Trinity/Scene/SceneRuntime.cpp`
- [Scene Manager](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Scene/SceneManager.cpp): `Trinity-Engine/Source/Trinity/Scene/SceneManager.cpp`
- [Scene Serialization](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Include/Trinity/Scene/SceneSerializer.hpp): `Trinity-Engine/Include/Trinity/Scene/SceneSerializer.hpp`
- [Asset Manager](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Asset/AssetManager.cpp): `Trinity-Engine/Source/Trinity/Asset/AssetManager.cpp`

### Engine Services

- [File System](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/FileSystem/FileSystem.cpp): `Trinity-Engine/Source/Trinity/FileSystem/FileSystem.cpp`
- [Audio Engine](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Audio/AudioEngine.cpp): `Trinity-Engine/Source/Trinity/Audio/AudioEngine.cpp`
- [Physics Worlds](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Physics/PhysicsWorld3D.cpp): `Trinity-Engine/Source/Trinity/Physics/PhysicsWorld3D.cpp`
- [Script Runtime](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Scripting/ScriptRuntime.cpp): `Trinity-Engine/Source/Trinity/Scripting/ScriptRuntime.cpp`
- [C# Script API](https://github.com/thattanishqtak/trinity/blob/main/Trinity-ScriptCore/Source/Types/Entity.cs): `Trinity-ScriptCore/Source/Types/Entity.cs`
- [Game UI](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/UI/GameUI.cpp): `Trinity-Engine/Source/Trinity/UI/GameUI.cpp`
- [Engine Manifest](https://github.com/thattanishqtak/trinity/blob/main/Trinity-Engine/Source/Trinity/Project/EngineManifest.cpp): `Trinity-Engine/Source/Trinity/Project/EngineManifest.cpp`

### Other components

- **User**

## Connections

- User → Project Hub: opens project (evidence: `README.md`)
- Project Hub → Forge Editor: starts Forge (evidence: `README.md`)
- Forge Editor → Application Loop: links engine (evidence: `README.md`)
- Sandbox → Application Loop: links engine (evidence: `README.md`)
- Application Loop → Audio Engine: uses audio
- Application Loop → Renderer: uses renderer
- Application Loop → Graphics Devices: uses device
- Application Loop → Game UI: uses UI
- Application Loop → Asset Manager: initializes assets (evidence: `Trinity-Engine/Source/Trinity/Core/Application.cpp`)
- Application Loop → File System: uses filesystem (evidence: `Trinity-Engine/Source/Trinity/Core/Application.cpp`)
- Scene Manager → Asset Manager: loads assets (evidence: `Trinity-Engine/Source/Trinity/Scene/SceneManager.cpp`)
- Scene Manager → Scene Runtime: runs scenes
- Scene Manager → File System: reads files (evidence: `Trinity-Engine/Source/Trinity/Scene/SceneManager.cpp`)
- C# Script API → Script Runtime: calls native API (evidence: `Trinity-ScriptCore/Source/Types/Entity.cs`)
- User → Forge Editor: edits project (evidence: `README.md`)
- Project Hub → Engine Manifest: reads version info
