# honoured-1-byte/omniverse architecture

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

- Interactive diagram: https://gitdiagram.com/honoured-1-byte/omniverse
- Repository: https://github.com/honoured-1-byte/omniverse

## Overview

OmniVerse is a browser-based portfolio presented as a desktop OS. On desktop, users pass through the boot screen into a windowed workspace, launch native or harbored apps, and manage them through window controls and the taskbar; narrow screens use a mobile launcher instead. OmniBrain sends chat requests to a separate AI service and can open registered apps from its replies. The README also describes embedded games and live project harboring. Unsampled modules are represented only where the README or source index supports their role; edges reflect documented or indexed relationships.

Main entry points: [`desktop-ui/src/config/harborRegistry.jsx`](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/config/harborRegistry.jsx) (Harbor Registry), [`desktop-ui/src/App.jsx`](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/App.jsx) (App Router), [`desktop-ui/src/components/os/Desktop.jsx`](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/Desktop.jsx) (Desktop Workspace), [`desktop-ui/src/context/OSContext.jsx`](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/context/OSContext.jsx) (OS Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["OS Runtime"]
  node_app["App Router<br/>[App.jsx]"]
  node_bios["BIOS Boot<br/>[BiosBoot.jsx]"]
  node_mobile["Mobile Launcher<br/>[MobileLauncher.jsx]"]
  node_desktop["Desktop Workspace<br/>[Desktop.jsx]"]
  node_appgrid["App Grid<br/>[AppGrid.jsx]"]
  node_window["Window Frame<br/>[WindowFrame.jsx]"]
  node_taskbar["Taskbar<br/>[Taskbar.jsx]"]
  node_cursor["Reptile Cursor<br/>[ReptileCursor.jsx]"]
end

subgraph group_apps["Portfolio Apps"]
  node_about["About Me<br/>[AboutMe.jsx]"]
  node_resume["Resume Viewer<br/>[ResumeViewer.jsx]"]
  node_browser["OmniWeb<br/>[OmniWeb.jsx]"]
  node_camera["OmniCam<br/>[OmniCam.jsx]"]
  node_terminal["Terminal<br/>[Terminal.jsx]"]
end

subgraph group_harbor["Harbored Projects"]
  node_registry["Harbor Registry<br/>[harborRegistry.jsx]"]
  node_games["Embedded Games"]
  node_cinema["Cinema Projects"]
end

subgraph group_ai["AI Service"]
  node_brain["OmniBrain<br/>[OmniBrain.jsx]"]
  node_ai_engine["AI Engine<br/>[server.js]"]
end

subgraph group_state["Window State"]
  node_context["OS Context<br/>[OSContext.jsx]"]
  node_cache["LRU Cache<br/>[LRUCache.js]"]
end

node_visitor(("Visitor"))
node_gemini["Google Gemini"]
node_live_projects["Live Projects"]

node_visitor -->|"opens"| node_app
node_app -->|"shows boot"| node_bios
node_app -->|"routes mobile"| node_mobile
node_app -->|"provides state"| node_context
node_app -->|"renders desktop"| node_desktop
node_desktop -->|"renders"| node_appgrid
node_desktop -->|"renders"| node_window
node_desktop -->|"renders"| node_taskbar
node_desktop -->|"renders"| node_cursor
node_appgrid -->|"lists apps"| node_registry
node_mobile -->|"lists apps"| node_registry
node_taskbar -->|"uses state"| node_context
node_window -->|"uses state"| node_context
node_context -->|"manages capacity"| node_cache
node_registry -->|"registers"| node_about
node_registry -->|"registers"| node_resume
node_registry -->|"registers"| node_browser
node_registry -->|"registers"| node_camera
node_registry -->|"registers"| node_terminal
node_registry -->|"registers"| node_brain
node_registry -->|"harbors locally"| node_games
node_registry -->|"harbors locally"| node_cinema
node_registry -->|"harbors remotely"| node_live_projects
node_about -->|"opens links"| node_browser
node_brain -->|"posts chat"| node_ai_engine
node_brain -->|"dispatches app opens"| node_registry
node_ai_engine -->|"uses AI"| node_gemini

click node_app "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/App.jsx"
click node_bios "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/BiosBoot.jsx"
click node_mobile "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/MobileLauncher.jsx"
click node_desktop "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/Desktop.jsx"
click node_appgrid "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/AppGrid.jsx"
click node_window "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/WindowFrame.jsx"
click node_taskbar "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/Taskbar.jsx"
click node_cursor "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/ReptileCursor.jsx"
click node_registry "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/config/harborRegistry.jsx"
click node_context "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/context/OSContext.jsx"
click node_cache "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/utils/LRUCache.js"
click node_about "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/AboutMe.jsx"
click node_resume "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/ResumeViewer.jsx"
click node_browser "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/OmniWeb.jsx"
click node_camera "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/OmniCam.jsx"
click node_terminal "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/Terminal.jsx"
click node_brain "https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/OmniBrain/OmniBrain.jsx"
click node_ai_engine "https://github.com/honoured-1-byte/omniverse/blob/main/ai-engine/server.js"
click node_games "https://github.com/honoured-1-byte/omniverse/tree/main/desktop-ui/public/apps/games"
click node_cinema "https://github.com/honoured-1-byte/omniverse/tree/main/desktop-ui/public/apps/cinema"

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_bios,node_mobile,node_desktop,node_appgrid,node_window,node_taskbar,node_cursor toneBlue
class node_about,node_resume,node_browser,node_camera,node_terminal toneAmber
class node_registry,node_games,node_cinema toneMint
class node_brain,node_ai_engine toneRose
class node_context,node_cache,node_visitor,node_gemini,node_live_projects toneIndigo
```

## Components

### OS Runtime

- [App Router](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/App.jsx): `desktop-ui/src/App.jsx`
- [BIOS Boot](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/BiosBoot.jsx): `desktop-ui/src/components/os/BiosBoot.jsx`
- [Mobile Launcher](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/MobileLauncher.jsx): `desktop-ui/src/components/os/MobileLauncher.jsx`
- [Desktop Workspace](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/Desktop.jsx): `desktop-ui/src/components/os/Desktop.jsx`
- [App Grid](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/AppGrid.jsx): `desktop-ui/src/components/os/AppGrid.jsx`
- [Window Frame](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/WindowFrame.jsx): `desktop-ui/src/components/os/WindowFrame.jsx`
- [Taskbar](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/Taskbar.jsx): `desktop-ui/src/components/os/Taskbar.jsx`
- [Reptile Cursor](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/os/ReptileCursor.jsx): `desktop-ui/src/components/os/ReptileCursor.jsx`

### Portfolio Apps

- [About Me](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/AboutMe.jsx): `desktop-ui/src/components/apps/AboutMe.jsx`
- [Resume Viewer](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/ResumeViewer.jsx): `desktop-ui/src/components/apps/ResumeViewer.jsx`
- [OmniWeb](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/OmniWeb.jsx): `desktop-ui/src/components/apps/OmniWeb.jsx`
- [OmniCam](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/OmniCam.jsx): `desktop-ui/src/components/apps/OmniCam.jsx`
- [Terminal](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/apps/Terminal.jsx): `desktop-ui/src/components/apps/Terminal.jsx`

### Harbored Projects

- [Harbor Registry](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/config/harborRegistry.jsx): `desktop-ui/src/config/harborRegistry.jsx`
- [Embedded Games](https://github.com/honoured-1-byte/omniverse/tree/main/desktop-ui/public/apps/games): `desktop-ui/public/apps/games`
- [Cinema Projects](https://github.com/honoured-1-byte/omniverse/tree/main/desktop-ui/public/apps/cinema): `desktop-ui/public/apps/cinema`

### AI Service

- [OmniBrain](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/components/OmniBrain/OmniBrain.jsx): `desktop-ui/src/components/OmniBrain/OmniBrain.jsx`
- [AI Engine](https://github.com/honoured-1-byte/omniverse/blob/main/ai-engine/server.js): `ai-engine/server.js`

### Window State

- [OS Context](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/context/OSContext.jsx): `desktop-ui/src/context/OSContext.jsx`
- [LRU Cache](https://github.com/honoured-1-byte/omniverse/blob/main/desktop-ui/src/utils/LRUCache.js): `desktop-ui/src/utils/LRUCache.js`

### Other components

- **Visitor**
- **Google Gemini**
- **Live Projects**

## Connections

- Visitor → App Router: opens (evidence: `README.md`)
- App Router → BIOS Boot: shows boot (evidence: `desktop-ui/src/App.jsx`)
- App Router → Mobile Launcher: routes mobile (evidence: `desktop-ui/src/App.jsx`)
- App Router → OS Context: provides state (evidence: `desktop-ui/src/App.jsx`)
- App Router → Desktop Workspace: renders desktop (evidence: `desktop-ui/src/App.jsx`)
- Desktop Workspace → App Grid: renders (evidence: `desktop-ui/src/components/os/Desktop.jsx`)
- Desktop Workspace → Window Frame: renders (evidence: `desktop-ui/src/components/os/Desktop.jsx`)
- Desktop Workspace → Taskbar: renders (evidence: `desktop-ui/src/components/os/Desktop.jsx`)
- Desktop Workspace → Reptile Cursor: renders (evidence: `desktop-ui/src/components/os/Desktop.jsx`)
- App Grid → Harbor Registry: lists apps (evidence: `desktop-ui/src/components/os/AppGrid.jsx`)
- Mobile Launcher → Harbor Registry: lists apps (evidence: `desktop-ui/src/components/os/MobileLauncher.jsx`)
- Taskbar → OS Context: uses state (evidence: `desktop-ui/src/components/os/Taskbar.jsx`)
- Window Frame → OS Context: uses state (evidence: `desktop-ui/src/components/os/WindowFrame.jsx`)
- OS Context → LRU Cache: manages capacity (evidence: `desktop-ui/src/context/OSContext.jsx`)
- Harbor Registry → About Me: registers (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → Resume Viewer: registers (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → OmniWeb: registers (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → OmniCam: registers (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → Terminal: registers (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → OmniBrain: registers (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → Embedded Games: harbors locally (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → Cinema Projects: harbors locally (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- Harbor Registry → Live Projects: harbors remotely (evidence: `desktop-ui/src/config/harborRegistry.jsx`)
- About Me → OmniWeb: opens links (evidence: `desktop-ui/src/components/apps/AboutMe.jsx`)
- OmniBrain → AI Engine: posts chat (evidence: `desktop-ui/src/components/OmniBrain/OmniBrain.jsx`)
- OmniBrain → Harbor Registry: dispatches app opens (evidence: `desktop-ui/src/components/OmniBrain/OmniBrain.jsx`)
- AI Engine → Google Gemini: uses AI (evidence: `README.md`)
