# maltekruse23-oss/blank architecture

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

- Interactive diagram: https://gitdiagram.com/maltekruse23-oss/blank
- Repository: https://github.com/maltekruse23-oss/blank

## Overview

blank. is a Windows desktop companion for Twitch, League of Legends ARAM, music, and PC/device status. Users open the app, choose a feature, and act on live data or settings; the React shell routes to feature pages and Tauri adapters connect desktop capabilities. The README documents additional features whose implementation was not sampled, including Twitch co-watching, settings transfer, Windows gaming tweaks, and app popouts. Edges for those documented behaviors cite the README; source-level connections are limited to indexed or excerpted evidence.

Main entry points: [`src/app/App.tsx`](https://github.com/maltekruse23-oss/blank/blob/main/src/app/App.tsx) (App shell), [`src/features/pros/usePros.ts`](https://github.com/maltekruse23-oss/blank/blob/main/src/features/pros/usePros.ts) (Pro streams), [`src/features/aram/useAram.ts`](https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/useAram.ts) (ARAM workflows), [`src/adapters/twitch.ts`](https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/twitch.ts) (Twitch adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["App shell"]
  node_app["App shell<br/>[App.tsx]"]
  node_entry["Window entry<br/>[main.tsx]"]
end

subgraph group_social["Twitch and music"]
  node_twitch["Twitch features<br/>[useTwitch.ts]"]
  node_twitch_api["Twitch adapter<br/>[twitch.ts]"]
  node_pros["Pro streams<br/>[usePros.ts]"]
  node_pro_data["Pro streamer list<br/>[proStreamers.ts]"]
  node_watch["Watch rooms<br/>[watchRoom.ts]"]
  node_extension["Browser extension<br/>[background.ts]"]
  node_mqtt["Room transport<br/>[mqtt.ts]"]
  node_music["SoundCloud mixes<br/>[useMusic.tsx]"]
  node_soundcloud["SoundCloud adapter<br/>[soundcloud.ts]"]
end

subgraph group_aram["ARAM leaderboard"]
  node_aram_ui["ARAM experience<br/>[AramPage.tsx]"]
  node_aram_hooks["ARAM workflows<br/>[useAram.ts]"]
  node_aram_rating["Ranking logic<br/>[aramRating.ts]"]
  node_aram_adapter["League data adapter<br/>[aram.ts]"]
  node_aram_native["League integration<br/>[aram.rs]"]
  node_group_sync["Group leaderboard<br/>[useAramGroup.ts]"]
end

subgraph group_system["PC and apps"]
  node_devices["Device batteries<br/>[useBatteries.ts]"]
  node_device_adapter["Device adapter<br/>[devices.ts]"]
  node_pc["PC status<br/>[pc.ts]"]
  node_apps["Program install and backup<br/>[apps.rs]"]
  node_tweaks["Gaming optimization<br/>[tweaks.rs]"]
end

subgraph group_experience["Settings and popouts"]
  node_settings["Preferences and transfer<br/>[preferences.ts]"]
  node_store[("Settings mirror<br/>[store.ts]")]
  node_popouts["Popout notifications<br/>[usePopouts.ts]"]
  node_popout_bridge["Popout bridge<br/>[popout.ts]"]
  node_design["Themes and motion<br/>[customization.ts]"]
end

node_user(("User"))
node_twitch_service(("Twitch service"))
node_soundcloud_service(("SoundCloud service"))
node_league_client(("League client"))
node_mqtt_service(("MQTT brokers"))
node_windows(("Windows devices"))

node_user -->|"opens"| node_entry
node_entry -->|"loads"| node_app
node_app -->|"routes to"| node_twitch
node_app -->|"routes to"| node_pros
node_app -->|"routes to"| node_aram_ui
node_pros -->|"reads"| node_pro_data
node_pros -->|"queries"| node_twitch_api
node_twitch -->|"uses"| node_twitch_api
node_twitch_api -.->|"requests"| node_twitch_service
node_app -.->|"offers co-watching"| node_watch
node_extension -->|"shares room codes"| node_watch
node_extension -->|"uses transport"| node_mqtt
node_mqtt -.->|"connects"| node_mqtt_service
node_music -->|"calls"| node_soundcloud
node_soundcloud -.->|"plays mixes"| node_soundcloud_service
node_aram_ui -.->|"uses"| node_aram_hooks
node_aram_hooks -->|"syncs games"| node_aram_adapter
node_aram_adapter -->|"invokes"| node_aram_native
node_aram_native -.->|"reads matches"| node_league_client
node_aram_hooks -.->|"supports groups"| node_group_sync
node_aram_rating -.->|"ranks games"| node_aram_ui
node_devices -->|"reads batteries"| node_device_adapter
node_device_adapter -.->|"reads devices"| node_windows
node_pc -.->|"reads metrics"| node_windows
node_app -.->|"offers app tools"| node_apps
node_app -.->|"offers gaming tweaks"| node_tweaks
node_app -->|"loads preferences"| node_settings
node_app -->|"restores settings"| node_store
node_settings -->|"resolves customization"| node_design
node_app -.->|"manages notifications"| node_popouts
node_popouts -->|"updates windows"| node_popout_bridge
node_popout_bridge -.->|"shows overlays"| node_windows

click node_app "https://github.com/maltekruse23-oss/blank/blob/main/src/app/App.tsx"
click node_entry "https://github.com/maltekruse23-oss/blank/blob/main/src/main.tsx"
click node_twitch "https://github.com/maltekruse23-oss/blank/blob/main/src/features/twitch/useTwitch.ts"
click node_twitch_api "https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/twitch.ts"
click node_pros "https://github.com/maltekruse23-oss/blank/blob/main/src/features/pros/usePros.ts"
click node_pro_data "https://github.com/maltekruse23-oss/blank/blob/main/src/data/proStreamers.ts"
click node_watch "https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/watchRoom.ts"
click node_extension "https://github.com/maltekruse23-oss/blank/blob/main/extension/src/background.ts"
click node_mqtt "https://github.com/maltekruse23-oss/blank/blob/main/extension/src/mqtt.ts"
click node_music "https://github.com/maltekruse23-oss/blank/blob/main/src/features/music/useMusic.tsx"
click node_soundcloud "https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/soundcloud.ts"
click node_aram_ui "https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/AramPage.tsx"
click node_aram_hooks "https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/useAram.ts"
click node_aram_rating "https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/aramRating.ts"
click node_aram_adapter "https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/aram.ts"
click node_aram_native "https://github.com/maltekruse23-oss/blank/blob/main/src-tauri/src/aram.rs"
click node_group_sync "https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/useAramGroup.ts"
click node_devices "https://github.com/maltekruse23-oss/blank/blob/main/src/features/devices/useBatteries.ts"
click node_device_adapter "https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/devices.ts"
click node_pc "https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/pc.ts"
click node_apps "https://github.com/maltekruse23-oss/blank/blob/main/src-tauri/src/apps.rs"
click node_tweaks "https://github.com/maltekruse23-oss/blank/blob/main/src-tauri/src/tweaks.rs"
click node_settings "https://github.com/maltekruse23-oss/blank/blob/main/src/features/settings/preferences.ts"
click node_store "https://github.com/maltekruse23-oss/blank/blob/main/src/platform/store.ts"
click node_popouts "https://github.com/maltekruse23-oss/blank/blob/main/src/features/popouts/usePopouts.ts"
click node_popout_bridge "https://github.com/maltekruse23-oss/blank/blob/main/src/platform/popout.ts"
click node_design "https://github.com/maltekruse23-oss/blank/blob/main/src/design/customization.ts"

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_entry,node_user,node_league_client toneBlue
class node_twitch,node_twitch_api,node_pros,node_pro_data,node_watch,node_extension,node_mqtt,node_music,node_soundcloud toneAmber
class node_aram_ui,node_aram_hooks,node_aram_rating,node_aram_adapter,node_aram_native,node_group_sync toneMint
class node_devices,node_device_adapter,node_pc,node_apps,node_tweaks toneRose
class node_settings,node_store,node_popouts,node_popout_bridge,node_design,node_twitch_service,node_soundcloud_service,node_mqtt_service,node_windows toneIndigo
```

## Components

### App shell

- [App shell](https://github.com/maltekruse23-oss/blank/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [Window entry](https://github.com/maltekruse23-oss/blank/blob/main/src/main.tsx): `src/main.tsx`

### Twitch and music

- [Twitch features](https://github.com/maltekruse23-oss/blank/blob/main/src/features/twitch/useTwitch.ts): `src/features/twitch/useTwitch.ts`
- [Twitch adapter](https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/twitch.ts): `src/adapters/twitch.ts`
- [Pro streams](https://github.com/maltekruse23-oss/blank/blob/main/src/features/pros/usePros.ts): `src/features/pros/usePros.ts`
- [Pro streamer list](https://github.com/maltekruse23-oss/blank/blob/main/src/data/proStreamers.ts): `src/data/proStreamers.ts`
- [Watch rooms](https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/watchRoom.ts): `src/adapters/watchRoom.ts`
- [Browser extension](https://github.com/maltekruse23-oss/blank/blob/main/extension/src/background.ts): `extension/src/background.ts`
- [Room transport](https://github.com/maltekruse23-oss/blank/blob/main/extension/src/mqtt.ts): `extension/src/mqtt.ts`
- [SoundCloud mixes](https://github.com/maltekruse23-oss/blank/blob/main/src/features/music/useMusic.tsx): `src/features/music/useMusic.tsx`
- [SoundCloud adapter](https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/soundcloud.ts): `src/adapters/soundcloud.ts`

### ARAM leaderboard

- [ARAM experience](https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/AramPage.tsx): `src/features/aram/AramPage.tsx`
- [ARAM workflows](https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/useAram.ts): `src/features/aram/useAram.ts`
- [Ranking logic](https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/aramRating.ts): `src/features/aram/aramRating.ts`
- [League data adapter](https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/aram.ts): `src/adapters/aram.ts`
- [League integration](https://github.com/maltekruse23-oss/blank/blob/main/src-tauri/src/aram.rs): `src-tauri/src/aram.rs`
- [Group leaderboard](https://github.com/maltekruse23-oss/blank/blob/main/src/features/aram/useAramGroup.ts): `src/features/aram/useAramGroup.ts`

### PC and apps

- [Device batteries](https://github.com/maltekruse23-oss/blank/blob/main/src/features/devices/useBatteries.ts): `src/features/devices/useBatteries.ts`
- [Device adapter](https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/devices.ts): `src/adapters/devices.ts`
- [PC status](https://github.com/maltekruse23-oss/blank/blob/main/src/adapters/pc.ts): `src/adapters/pc.ts`
- [Program install and backup](https://github.com/maltekruse23-oss/blank/blob/main/src-tauri/src/apps.rs): `src-tauri/src/apps.rs`
- [Gaming optimization](https://github.com/maltekruse23-oss/blank/blob/main/src-tauri/src/tweaks.rs): `src-tauri/src/tweaks.rs`

### Settings and popouts

- [Preferences and transfer](https://github.com/maltekruse23-oss/blank/blob/main/src/features/settings/preferences.ts): `src/features/settings/preferences.ts`
- [Settings mirror](https://github.com/maltekruse23-oss/blank/blob/main/src/platform/store.ts): `src/platform/store.ts`
- [Popout notifications](https://github.com/maltekruse23-oss/blank/blob/main/src/features/popouts/usePopouts.ts): `src/features/popouts/usePopouts.ts`
- [Popout bridge](https://github.com/maltekruse23-oss/blank/blob/main/src/platform/popout.ts): `src/platform/popout.ts`
- [Themes and motion](https://github.com/maltekruse23-oss/blank/blob/main/src/design/customization.ts): `src/design/customization.ts`

### Other components

- **User**
- **Twitch service**
- **SoundCloud service**
- **League client**
- **MQTT brokers**
- **Windows devices**

## Connections

- User → Window entry: opens (evidence: `README.md`)
- Window entry → App shell: loads (evidence: `src/main.tsx`)
- App shell → Twitch features: routes to (evidence: `src/app/App.tsx`)
- App shell → Pro streams: routes to (evidence: `src/app/App.tsx`)
- App shell → ARAM experience: routes to (evidence: `src/app/App.tsx`)
- Pro streams → Pro streamer list: reads (evidence: `src/features/pros/usePros.ts`)
- Pro streams → Twitch adapter: queries (evidence: `src/features/pros/usePros.ts`)
- Twitch features → Twitch adapter: uses (evidence: `src/features/twitch/useTwitch.ts`)
- Twitch adapter → Twitch service: requests (evidence: `README.md`)
- App shell → Watch rooms: offers co-watching (evidence: `README.md`)
- Browser extension → Watch rooms: shares room codes (evidence: `extension/src/background.ts`)
- Browser extension → Room transport: uses transport (evidence: `extension/src/background.ts`)
- Room transport → MQTT brokers: connects (evidence: `README.md`)
- SoundCloud mixes → SoundCloud adapter: calls (evidence: `src/features/music/useMusic.tsx`)
- SoundCloud adapter → SoundCloud service: plays mixes (evidence: `README.md`)
- ARAM experience → ARAM workflows: uses
- ARAM workflows → League data adapter: syncs games
- League data adapter → League integration: invokes (evidence: `src/adapters/aram.ts`)
- League integration → League client: reads matches (evidence: `README.md`)
- ARAM workflows → Group leaderboard: supports groups (evidence: `README.md`)
- Ranking logic → ARAM experience: ranks games
- Device batteries → Device adapter: reads batteries (evidence: `src/features/devices/useBatteries.ts`)
- Device adapter → Windows devices: reads devices (evidence: `README.md`)
- PC status → Windows devices: reads metrics (evidence: `README.md`)
- App shell → Program install and backup: offers app tools (evidence: `README.md`)
- App shell → Gaming optimization: offers gaming tweaks (evidence: `README.md`)
- App shell → Preferences and transfer: loads preferences (evidence: `src/app/App.tsx`)
- App shell → Settings mirror: restores settings (evidence: `src/main.tsx`)
- Preferences and transfer → Themes and motion: resolves customization (evidence: `src/features/settings/preferences.ts`)
- App shell → Popout notifications: manages notifications (evidence: `README.md`)
- Popout notifications → Popout bridge: updates windows (evidence: `src/features/popouts/usePopouts.ts`)
- Popout bridge → Windows devices: shows overlays (evidence: `README.md`)
