# jeoooo/dota-gsi-obs-overlay architecture

> Architecture diagram of the GitHub repository jeoooo/dota-gsi-obs-overlay, 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/jeoooo/dota-gsi-obs-overlay
- Repository: https://github.com/jeoooo/dota-gsi-obs-overlay

## Overview

This repository is a Dota 2 Game State Integration overlay for OBS/browser-source use. Dota sends match state to a Node.js GSI listener, which forwards updates over Socket.IO; broadcasters open the Svelte UI to view draft picks/bans and experimental scoreboard views. The graph includes both documented product views and the sampled implementation. The README describes the integration flow, while unsampled routes and the largely empty Draft2 route are represented only at the level supported by the tree and excerpts.

Main entry points: [`svelte-app/src/App.svelte`](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/App.svelte) (Route selector), [`svelte-app/src/routes/Draft.svelte`](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Draft.svelte) (Draft state and layout), [`index.js`](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/index.js) (Socket.IO relay), [`svelte-app/src/main.js`](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/main.js) (Svelte entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Game Data Ingestion"]
  node_gsi["GSI listener<br/>[index.js]"]
  node_relay["Socket.IO relay<br/>[index.js]"]
  node_static["Static app hosting<br/>[index.js]"]
end

subgraph group_ui["Overlay Navigation"]
  node_entry["Svelte entry<br/>[main.js]"]
  node_router["Route selector<br/>[App.svelte]"]
  node_home["Overlay home<br/>[Index.svelte]"]
end

subgraph group_draft["Draft Overlay"]
  node_draft["Draft state and layout<br/>[Draft.svelte]"]
  node_draft2["Draft2 route<br/>[Draft2.svelte]"]
  node_center["Draft timer panel"]
  node_picks["Hero pick display<br/>[HeroPick2.svelte]"]
  node_bans["Hero ban display<br/>[HeroBans2.svelte]"]
  node_center1["Center panel variant"]
end

subgraph group_score["Scoreboard Views"]
  node_score1["Scoreboard view<br/>[Scoreboard.svelte]"]
  node_score2["Scoreboard variant<br/>[Scoreboard2.svelte]"]
end

node_dota(("Dota 2 client"))
node_broadcaster(("Broadcaster"))

node_dota -->|"sends game state"| node_gsi
node_gsi -->|"registers clients"| node_relay
node_relay -->|"streams updates"| node_draft
node_relay -->|"streams updates"| node_score1
node_relay -->|"streams updates"| node_score2
node_broadcaster -->|"opens overlay"| node_static
node_static -->|"serves app"| node_entry
node_entry -->|"mounts"| node_router
node_router -->|"routes to"| node_home
node_router -->|"routes to"| node_draft
node_router -->|"routes to"| node_draft2
node_router -->|"routes to"| node_score1
node_router -->|"routes to"| node_score2
node_draft -->|"renders"| node_center
node_draft -->|"renders"| node_picks
node_draft -->|"renders"| node_bans

click node_gsi "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/index.js"
click node_relay "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/index.js"
click node_static "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/index.js"
click node_entry "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/main.js"
click node_router "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/App.svelte"
click node_home "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/Index.svelte"
click node_draft "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Draft.svelte"
click node_draft2 "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Draft2.svelte"
click node_center "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/CenterScreen2.svelte"
click node_picks "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/HeroPick2.svelte"
click node_bans "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/HeroBans2.svelte"
click node_center1 "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/CenterScreen.svelte"
click node_score1 "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Scoreboard.svelte"
click node_score2 "https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Scoreboard2.svelte"

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_gsi,node_relay,node_static,node_dota toneBlue
class node_entry,node_router,node_home toneAmber
class node_draft,node_draft2,node_center,node_picks,node_bans,node_center1 toneMint
class node_score1,node_score2 toneRose
class node_broadcaster toneIndigo
```

## Components

### Game Data Ingestion

- [GSI listener](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/index.js): `index.js`
- [Socket.IO relay](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/index.js): `index.js`
- [Static app hosting](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/index.js): `index.js`

### Overlay Navigation

- [Svelte entry](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/main.js): `svelte-app/src/main.js`
- [Route selector](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/App.svelte): `svelte-app/src/App.svelte`
- [Overlay home](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/Index.svelte): `svelte-app/src/Index.svelte`

### Draft Overlay

- [Draft state and layout](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Draft.svelte): `svelte-app/src/routes/Draft.svelte`
- [Draft2 route](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Draft2.svelte): `svelte-app/src/routes/Draft2.svelte`
- [Draft timer panel](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/CenterScreen2.svelte): `svelte-app/src/components/CenterScreen2.svelte`
- [Hero pick display](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/HeroPick2.svelte): `svelte-app/src/components/HeroPick2.svelte`
- [Hero ban display](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/HeroBans2.svelte): `svelte-app/src/components/HeroBans2.svelte`
- [Center panel variant](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/components/CenterScreen.svelte): `svelte-app/src/components/CenterScreen.svelte`

### Scoreboard Views

- [Scoreboard view](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Scoreboard.svelte): `svelte-app/src/routes/Scoreboard.svelte`
- [Scoreboard variant](https://github.com/jeoooo/dota-gsi-obs-overlay/blob/svelte-remake/svelte-app/src/routes/Scoreboard2.svelte): `svelte-app/src/routes/Scoreboard2.svelte`

### Other components

- **Dota 2 client**
- **Broadcaster**

## Connections

- Dota 2 client → GSI listener: sends game state (evidence: `README.md`)
- GSI listener → Socket.IO relay: registers clients (evidence: `index.js`)
- Socket.IO relay → Draft state and layout: streams updates (evidence: `README.md`)
- Socket.IO relay → Scoreboard view: streams updates (evidence: `README.md`)
- Socket.IO relay → Scoreboard variant: streams updates (evidence: `README.md`)
- Broadcaster → Static app hosting: opens overlay (evidence: `README.md`)
- Static app hosting → Svelte entry: serves app (evidence: `index.js`)
- Svelte entry → Route selector: mounts (evidence: `svelte-app/src/main.js`)
- Route selector → Overlay home: routes to (evidence: `svelte-app/src/App.svelte`)
- Route selector → Draft state and layout: routes to (evidence: `svelte-app/src/App.svelte`)
- Route selector → Draft2 route: routes to (evidence: `svelte-app/src/App.svelte`)
- Route selector → Scoreboard view: routes to (evidence: `svelte-app/src/App.svelte`)
- Route selector → Scoreboard variant: routes to (evidence: `svelte-app/src/App.svelte`)
- Draft state and layout → Draft timer panel: renders (evidence: `svelte-app/src/routes/Draft.svelte`)
- Draft state and layout → Hero pick display: renders (evidence: `svelte-app/src/routes/Draft.svelte`)
- Draft state and layout → Hero ban display: renders (evidence: `svelte-app/src/routes/Draft.svelte`)
