# youssefvdel/outpeek architecture

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

- Interactive diagram: https://gitdiagram.com/youssefvdel/outpeek
- Repository: https://github.com/youssefvdel/outpeek

## Overview

Outpeek is a Windows VALORANT companion and display toolkit. In the documented desktop workflow, a player opens the companion UI, which requests local-client and tracker.gg data through the frontend data layer and native bridge; the UI presents scouting, match history, and HUD views. Separate controls configure display modes and VALORANT settings through native Windows-facing code. The tree also contains a newer one-process Rust app and shared overlay crate. Relationships for unsampled subsystems are limited to documented capabilities and source-index references.

Main entry points: [`legacy/src/utils/ipc.ts`](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/ipc.ts) (Tauri bridge), [`outpeek-app/src/worker.rs`](https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/worker.rs) (Live poller), [`legacy/src/App.tsx`](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/App.tsx) (App shell), [`legacy/src/utils/tracker.ts`](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/tracker.ts) (Tracker data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Companion interface"]
  node_app["App shell<br/>[App.tsx]"]
  node_scouting["Scouting views<br/>[TrackerView.tsx]"]
  node_matchviews["Match views<br/>[MatchHistory.tsx]"]
  node_settingsui["Display controls<br/>[UtilityView.tsx]"]
  node_hudui["HUD views<br/>[OverlayView.tsx]"]
end

subgraph group_data["Scouting and match data"]
  node_trackerdata["Tracker data<br/>[tracker.ts]"]
  node_trndata["Tracker.gg data<br/>[trn.ts]"]
  node_datasources["Riot sources<br/>[riot.ts]"]
end

subgraph group_native["Desktop and display"]
  node_ipc["Tauri bridge<br/>[ipc.ts]"]
  node_display["Display engine<br/>[mod.rs]"]
  node_gameconfig["Game config<br/>[apply.rs]"]
  node_overlayrenderer["Overlay renderer"]
end

subgraph group_hud["In-game HUD"]
  node_hudconfig["HUD layout<br/>[overlayConfig.ts]"]
  node_drag["HUD dragging<br/>[useDrag.ts]"]
end

subgraph group_nativeapp["Native app stack"]
  node_nativeworker["Live poller<br/>[worker.rs]"]
  node_nativeapi["Live API<br/>[live_api.rs]"]
  node_nativemodel["Tracker snapshot<br/>[model.rs]"]
  node_nativeview["Tracker window<br/>[live_view.rs]"]
  node_rank["Rank lookup<br/>[rank.rs]"]
  node_nativeoverlay["Overlay surface<br/>[hud.rs]"]
end

node_player(("Player"))

node_player -->|"opens"| node_app
node_app -.->|"shows"| node_scouting
node_app -.->|"shows"| node_settingsui
node_scouting -.->|"loads"| node_trackerdata
node_trackerdata -->|"reads"| node_datasources
node_trackerdata -->|"enriches"| node_trndata
node_player -.->|"reviews"| node_matchviews
node_player -.->|"uses"| node_hudui
node_settingsui -->|"requests"| node_ipc
node_ipc -.->|"invokes"| node_display
node_ipc -.->|"invokes"| node_gameconfig
node_hudui -.->|"configures"| node_hudconfig
node_drag -->|"clamps positions"| node_hudconfig
node_ipc -->|"queries"| node_overlayrenderer
node_nativeworker -->|"polls"| node_nativeapi
node_nativeworker -.->|"publishes"| node_nativemodel
node_nativeview -->|"renders"| node_nativemodel
node_nativeapi -->|"reads rank"| node_rank
node_nativeworker -.->|"drives"| node_nativeoverlay

click node_app "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/App.tsx"
click node_scouting "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/TrackerView.tsx"
click node_matchviews "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/MatchHistory.tsx"
click node_settingsui "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/UtilityView.tsx"
click node_hudui "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/OverlayView.tsx"
click node_trackerdata "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/tracker.ts"
click node_trndata "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/trn.ts"
click node_datasources "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/sources/riot.ts"
click node_ipc "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/ipc.ts"
click node_display "https://github.com/youssefvdel/outpeek/blob/main/legacy/src-tauri/src/display/mod.rs"
click node_gameconfig "https://github.com/youssefvdel/outpeek/blob/main/legacy/src-tauri/src/game_config/apply.rs"
click node_overlayrenderer "https://github.com/youssefvdel/outpeek/blob/main/legacy/src-tauri/src/overlay_renderer.rs"
click node_hudconfig "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/hud/overlayConfig.ts"
click node_drag "https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/hud/useDrag.ts"
click node_nativeworker "https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/worker.rs"
click node_nativeapi "https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/live_api.rs"
click node_nativemodel "https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/model.rs"
click node_nativeview "https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/live_view.rs"
click node_rank "https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/rank.rs"
click node_nativeoverlay "https://github.com/youssefvdel/outpeek/blob/main/outpeek-overlay/src/hud.rs"

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_scouting,node_matchviews,node_settingsui,node_hudui toneBlue
class node_trackerdata,node_trndata,node_datasources toneAmber
class node_ipc,node_display,node_gameconfig,node_overlayrenderer toneMint
class node_hudconfig,node_drag toneRose
class node_nativeworker,node_nativeapi,node_nativemodel,node_nativeview,node_rank,node_nativeoverlay,node_player toneIndigo
```

## Components

### Companion interface

- [App shell](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/App.tsx): `legacy/src/App.tsx`
- [Scouting views](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/TrackerView.tsx): `legacy/src/components/TrackerView.tsx`
- [Match views](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/MatchHistory.tsx): `legacy/src/components/MatchHistory.tsx`
- [Display controls](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/UtilityView.tsx): `legacy/src/components/UtilityView.tsx`
- [HUD views](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/OverlayView.tsx): `legacy/src/components/OverlayView.tsx`

### Scouting and match data

- [Tracker data](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/tracker.ts): `legacy/src/utils/tracker.ts`
- [Tracker.gg data](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/trn.ts): `legacy/src/utils/trn.ts`
- [Riot sources](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/sources/riot.ts): `legacy/src/sources/riot.ts`

### Desktop and display

- [Tauri bridge](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/utils/ipc.ts): `legacy/src/utils/ipc.ts`
- [Display engine](https://github.com/youssefvdel/outpeek/blob/main/legacy/src-tauri/src/display/mod.rs): `legacy/src-tauri/src/display/mod.rs`
- [Game config](https://github.com/youssefvdel/outpeek/blob/main/legacy/src-tauri/src/game_config/apply.rs): `legacy/src-tauri/src/game_config/apply.rs`
- [Overlay renderer](https://github.com/youssefvdel/outpeek/blob/main/legacy/src-tauri/src/overlay_renderer.rs): `legacy/src-tauri/src/overlay_renderer.rs`

### In-game HUD

- [HUD layout](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/hud/overlayConfig.ts): `legacy/src/components/hud/overlayConfig.ts`
- [HUD dragging](https://github.com/youssefvdel/outpeek/blob/main/legacy/src/components/hud/useDrag.ts): `legacy/src/components/hud/useDrag.ts`

### Native app stack

- [Live poller](https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/worker.rs): `outpeek-app/src/worker.rs`
- [Live API](https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/live_api.rs): `outpeek-app/src/live_api.rs`
- [Tracker snapshot](https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/model.rs): `outpeek-app/src/model.rs`
- [Tracker window](https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/live_view.rs): `outpeek-app/src/live_view.rs`
- [Rank lookup](https://github.com/youssefvdel/outpeek/blob/main/outpeek-app/src/rank.rs): `outpeek-app/src/rank.rs`
- [Overlay surface](https://github.com/youssefvdel/outpeek/blob/main/outpeek-overlay/src/hud.rs): `outpeek-overlay/src/hud.rs`

### Other components

- **Player**

## Connections

- Player → App shell: opens
- App shell → Scouting views: shows (evidence: `legacy/src/App.tsx`)
- App shell → Display controls: shows (evidence: `legacy/src/App.tsx`)
- Scouting views → Tracker data: loads
- Tracker data → Riot sources: reads (evidence: `legacy/src/utils/tracker.ts`)
- Tracker data → Tracker.gg data: enriches (evidence: `legacy/src/hooks/useTrackerData.ts`)
- Player → Match views: reviews (evidence: `README.md`)
- Player → HUD views: uses (evidence: `README.md`)
- Display controls → Tauri bridge: requests (evidence: `legacy/src/App.tsx`)
- Tauri bridge → Display engine: invokes (evidence: `legacy/src/utils/ipc.ts`)
- Tauri bridge → Game config: invokes (evidence: `legacy/src/utils/ipc.ts`)
- HUD views → HUD layout: configures
- HUD dragging → HUD layout: clamps positions (evidence: `legacy/src/components/hud/useDrag.ts`)
- Tauri bridge → Overlay renderer: queries (evidence: `legacy/src/utils/ipc.ts`)
- Live poller → Live API: polls (evidence: `outpeek-app/src/worker.rs`)
- Live poller → Tracker snapshot: publishes (evidence: `outpeek-app/src/lib.rs`)
- Tracker window → Tracker snapshot: renders (evidence: `outpeek-app/src/live_view.rs`)
- Live API → Rank lookup: reads rank (evidence: `outpeek-app/src/live_api.rs`)
- Live poller → Overlay surface: drives
