# gxmi2006/winultra architecture

> Architecture diagram of the GitHub repository gxmi2006/winultra, 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/gxmi2006/winultra
- Repository: https://github.com/gxmi2006/winultra

## Overview

WinUltra is a Windows 11 desktop overlay. The main workflow is user input (hover or shortcut) opening the island, where tabs expose media, controls, system stats, clipboard, shelf and timers; the tray and setup window configure the app. The island is a single large source file, so its feature nodes share that path. README capabilities are represented, but unsampled implementation details and wiring are not inferred.

Main entry points: [`src/Island.cs`](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs) (Island shell), [`src/WinUltra.cs`](https://github.com/gxmi2006/winultra/blob/main/src/WinUltra.cs) (App startup), [`src/Setup.cs`](https://github.com/gxmi2006/winultra/blob/main/src/Setup.cs) (Setup window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["App lifecycle"]
  node_app["App startup<br/>[WinUltra.cs]"]
  node_tray["Tray menu<br/>[WinUltra.cs]"]
end

subgraph group_overlay["Island experience"]
  node_island["Island shell<br/>[Island.cs]"]
  node_media["Media tab<br/>[Island.cs]"]
  node_controls["Controls tab<br/>[Island.cs]"]
  node_stats["Stats tab<br/>[Island.cs]"]
  node_clipboard["Clipboard history<br/>[Island.cs]"]
  node_shelf["File shelf<br/>[Island.cs]"]
  node_timer["Timer and focus<br/>[Island.cs]"]
  node_live["Live pop-ups<br/>[Island.cs]"]
end

subgraph group_settings["Setup and settings"]
  node_setup["Setup window<br/>[Setup.cs]"]
end

subgraph group_state["Local state"]
  node_options["Options<br/>[WinUltra.cs]"]
  node_localdata[("Local app data<br/>[Island.cs]")]
end

node_user(("User"))

node_user -->|"launches"| node_app
node_app -->|"shows first run"| node_setup
node_app -->|"starts"| node_island
node_user -->|"opens by hover or shortcut"| node_island
node_island -->|"shows tab"| node_media
node_island -->|"shows tab"| node_controls
node_island -->|"shows tab"| node_stats
node_island -->|"shows tab"| node_clipboard
node_island -->|"shows tab"| node_shelf
node_island -->|"shows tab"| node_timer
node_island -->|"shows pop-ups"| node_live
node_user -->|"opens menu"| node_tray
node_tray -->|"opens"| node_island
node_tray -->|"opens settings"| node_setup
node_setup -->|"saves choices"| node_options
node_options -->|"stores settings"| node_localdata
node_clipboard -->|"saves pinned items"| node_localdata

click node_app "https://github.com/gxmi2006/winultra/blob/main/src/WinUltra.cs"
click node_tray "https://github.com/gxmi2006/winultra/blob/main/src/WinUltra.cs"
click node_setup "https://github.com/gxmi2006/winultra/blob/main/src/Setup.cs"
click node_island "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_media "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_controls "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_stats "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_clipboard "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_shelf "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_timer "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_live "https://github.com/gxmi2006/winultra/blob/main/src/Island.cs"
click node_options "https://github.com/gxmi2006/winultra/blob/main/src/WinUltra.cs"
click node_localdata "https://github.com/gxmi2006/winultra/blob/main/src/Island.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_app,node_tray,node_user toneBlue
class node_island,node_media,node_controls,node_stats,node_clipboard,node_shelf,node_timer,node_live toneAmber
class node_setup toneMint
class node_options,node_localdata toneRose
```

## Components

### App lifecycle

- [App startup](https://github.com/gxmi2006/winultra/blob/main/src/WinUltra.cs): `src/WinUltra.cs`
- [Tray menu](https://github.com/gxmi2006/winultra/blob/main/src/WinUltra.cs): `src/WinUltra.cs`

### Island experience

- [Island shell](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`
- [Media tab](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`
- [Controls tab](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`
- [Stats tab](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`
- [Clipboard history](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`
- [File shelf](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`
- [Timer and focus](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`
- [Live pop-ups](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`

### Setup and settings

- [Setup window](https://github.com/gxmi2006/winultra/blob/main/src/Setup.cs): `src/Setup.cs`

### Local state

- [Options](https://github.com/gxmi2006/winultra/blob/main/src/WinUltra.cs): `src/WinUltra.cs`
- [Local app data](https://github.com/gxmi2006/winultra/blob/main/src/Island.cs): `src/Island.cs`

### Other components

- **User**

## Connections

- User → App startup: launches (evidence: `README.md`)
- App startup → Setup window: shows first run (evidence: `src/WinUltra.cs`)
- App startup → Island shell: starts (evidence: `src/WinUltra.cs`)
- User → Island shell: opens by hover or shortcut (evidence: `README.md`)
- Island shell → Media tab: shows tab (evidence: `src/Island.cs`)
- Island shell → Controls tab: shows tab (evidence: `src/Island.cs`)
- Island shell → Stats tab: shows tab (evidence: `src/Island.cs`)
- Island shell → Clipboard history: shows tab (evidence: `src/Island.cs`)
- Island shell → File shelf: shows tab (evidence: `src/Island.cs`)
- Island shell → Timer and focus: shows tab (evidence: `src/Island.cs`)
- Island shell → Live pop-ups: shows pop-ups (evidence: `README.md`)
- User → Tray menu: opens menu (evidence: `README.md`)
- Tray menu → Island shell: opens (evidence: `src/WinUltra.cs`)
- Tray menu → Setup window: opens settings (evidence: `README.md`)
- Setup window → Options: saves choices (evidence: `src/Setup.cs`)
- Options → Local app data: stores settings (evidence: `src/WinUltra.cs`)
- Clipboard history → Local app data: saves pinned items (evidence: `src/Island.cs`)
