# bluebottlegg/leaguebroadcast-js-client-demo architecture

> Architecture diagram of the GitHub repository bluebottlegg/leaguebroadcast-js-client-demo, 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/bluebottlegg/leaguebroadcast-js-client-demo
- Repository: https://github.com/bluebottlegg/leaguebroadcast-js-client-demo

## Overview

League Broadcast Demo is a Vue overlay for LeagueBroadcast match data, rendered on a transparent 1920×1080 canvas for broadcast software. Its main workflow is to connect to the LeagueBroadcast server, expose reactive game state to overlay components, and render in-game graphics; separate routes provide champion select and post-game recaps. The README documents additional graphics and integrations beyond the sampled source. Edges to those unsampled capabilities are limited to documented routing or rendering relationships.

Main entry points: [`src/views/OverlayView.vue`](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/OverlayView.vue) (In-Game Overlay), [`src/composables/useIngame.ts`](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/composables/useIngame.ts) (Reactive Game State), [`src/router/index.ts`](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/router/index.ts) (Route Selection), [`src/client.ts`](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/client.ts) (Broadcast Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Routing"]
  node_bootstrap["App Bootstrap<br/>[main.ts]"]
  node_router["Route Selection<br/>[index.ts]"]
  node_combined["Combined View<br/>[CombinedView.vue]"]
  node_element_pages["Element Pages<br/>[elements.ts]"]
end

subgraph group_connection["Client and State"]
  node_client["Broadcast Client<br/>[client.ts]"]
  node_ingame_state["Reactive Game State<br/>[useIngame.ts]"]
end

subgraph group_ingame["In-Game Broadcast"]
  node_overlay["In-Game Overlay<br/>[OverlayView.vue]"]
  node_scoreboard["Scoreboards and Timers<br/>[Scoreboard.vue]"]
  node_game_panels["Game Information Panels<br/>[LFrame.vue]"]
  node_damage["Damage Analytics<br/>[DamageFlow.vue]"]
  node_damage_flow_data["Damage Flow Data<br/>[damageFlowData.ts]"]
  node_damage_sidebar["Damage Sidebars<br/>[DamageSidebar.vue]"]
  node_gold["Gold Analytics<br/>[GoldGraph.vue]"]
  node_kill_participation["Kill Participation"]
  node_objective_recap["Objective Recap<br/>[ObjectiveRecap.vue]"]
  node_twitch["Twitch Interactions<br/>[TwitchSidebar.vue]"]
end

subgraph group_pregame["Champion Select"]
  node_champ_select["Champion Select"]
  node_champ_3d["3D Champion Stage"]
end

subgraph group_postgame["Post-Game"]
  node_postgame_view["Post-Game View<br/>[PostgameView.vue]"]
  node_postgame_scene["Post-Game Recap<br/>[PostGameScene.vue]"]
  node_postgame_screens["Post-Game Data"]
  node_postgame_routes["Post-Game Screen Routing<br/>[postgameRoutes.ts]"]
end

node_viewer(("Broadcast Operator"))
node_broadcast_tool["OBS / vMix"]
node_server["LeagueBroadcast Server"]

node_viewer -->|"configures source"| node_broadcast_tool
node_broadcast_tool -->|"displays graphics"| node_overlay
node_bootstrap -->|"provides client"| node_client
node_bootstrap -->|"installs router"| node_router
node_client -->|"connects to"| node_server
node_router -->|"routes to"| node_combined
node_router -->|"routes to"| node_overlay
node_router -->|"routes to"| node_element_pages
node_router -->|"routes to"| node_champ_select
node_router -->|"routes to"| node_postgame_view
node_combined -.->|"layers"| node_overlay
node_overlay -->|"renders"| node_scoreboard
node_overlay -->|"renders"| node_game_panels
node_overlay -->|"renders"| node_damage
node_overlay -->|"renders"| node_damage_sidebar
node_overlay -->|"renders"| node_gold
node_overlay -->|"renders"| node_kill_participation
node_overlay -->|"renders"| node_objective_recap
node_overlay -->|"renders"| node_twitch
node_damage -->|"builds from"| node_damage_flow_data
node_client -->|"selects state"| node_ingame_state
node_ingame_state -->|"supplies state"| node_damage
node_ingame_state -->|"supplies state"| node_gold
node_ingame_state -->|"supplies state"| node_damage_sidebar
node_ingame_state -->|"supplies state"| node_kill_participation
node_ingame_state -->|"supplies state"| node_objective_recap
node_ingame_state -->|"supplies state"| node_twitch
node_champ_select -.->|"optional 3D stage"| node_champ_3d
node_postgame_view -.->|"shows recap"| node_postgame_scene
node_postgame_scene -.->|"loads screen data"| node_postgame_screens
node_postgame_scene -.->|"selects screens"| node_postgame_routes
node_postgame_screens -->|"fetches match data"| node_client

click node_bootstrap "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/main.ts"
click node_router "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/router/index.ts"
click node_combined "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/CombinedView.vue"
click node_overlay "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/OverlayView.vue"
click node_element_pages "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/elements.ts"
click node_client "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/client.ts"
click node_ingame_state "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/composables/useIngame.ts"
click node_scoreboard "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/Scoreboard/Scoreboard.vue"
click node_game_panels "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/LFrame/LFrame.vue"
click node_damage "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/DamageFlow/DamageFlow.vue"
click node_damage_flow_data "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/DamageFlow/damageFlowData.ts"
click node_damage_sidebar "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/DamageSidebar/DamageSidebar.vue"
click node_gold "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/GoldGraph/GoldGraph.vue"
click node_kill_participation "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/KillParticipation/KillParticipation.vue"
click node_objective_recap "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/ObjectiveRecap/ObjectiveRecap.vue"
click node_twitch "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/TwitchSidebar/TwitchSidebar.vue"
click node_champ_select "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/ChampionSelect/ChampionSelectScene.vue"
click node_champ_3d "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/ChampionSelect/3d/ChampionStage3D.vue"
click node_postgame_view "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/PostgameView.vue"
click node_postgame_scene "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/PostGame/PostGameScene.vue"
click node_postgame_screens "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/composables/usePostGameScreens.ts"
click node_postgame_routes "https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/PostGame/postgameRoutes.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_bootstrap,node_router,node_combined,node_element_pages toneBlue
class node_client,node_ingame_state toneAmber
class node_overlay,node_scoreboard,node_game_panels,node_damage,node_damage_flow_data,node_damage_sidebar,node_gold,node_kill_participation,node_objective_recap,node_twitch,node_server toneMint
class node_champ_select,node_champ_3d toneRose
class node_postgame_view,node_postgame_scene,node_postgame_screens,node_postgame_routes,node_viewer,node_broadcast_tool toneIndigo
```

## Components

### Application Routing

- [App Bootstrap](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/main.ts): `src/main.ts`
- [Route Selection](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/router/index.ts): `src/router/index.ts`
- [Combined View](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/CombinedView.vue): `src/views/CombinedView.vue`
- [Element Pages](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/elements.ts): `src/views/elements.ts`

### Client and State

- [Broadcast Client](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/client.ts): `src/client.ts`
- [Reactive Game State](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/composables/useIngame.ts): `src/composables/useIngame.ts`

### In-Game Broadcast

- [In-Game Overlay](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/OverlayView.vue): `src/views/OverlayView.vue`
- [Scoreboards and Timers](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/Scoreboard/Scoreboard.vue): `src/components/Scoreboard/Scoreboard.vue`
- [Game Information Panels](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/LFrame/LFrame.vue): `src/components/LFrame/LFrame.vue`
- [Damage Analytics](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/DamageFlow/DamageFlow.vue): `src/components/DamageFlow/DamageFlow.vue`
- [Damage Flow Data](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/DamageFlow/damageFlowData.ts): `src/components/DamageFlow/damageFlowData.ts`
- [Damage Sidebars](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/DamageSidebar/DamageSidebar.vue): `src/components/DamageSidebar/DamageSidebar.vue`
- [Gold Analytics](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/GoldGraph/GoldGraph.vue): `src/components/GoldGraph/GoldGraph.vue`
- [Kill Participation](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/KillParticipation/KillParticipation.vue): `src/components/KillParticipation/KillParticipation.vue`
- [Objective Recap](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/ObjectiveRecap/ObjectiveRecap.vue): `src/components/ObjectiveRecap/ObjectiveRecap.vue`
- [Twitch Interactions](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/TwitchSidebar/TwitchSidebar.vue): `src/components/TwitchSidebar/TwitchSidebar.vue`

### Champion Select

- [Champion Select](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/ChampionSelect/ChampionSelectScene.vue): `src/components/ChampionSelect/ChampionSelectScene.vue`
- [3D Champion Stage](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/ChampionSelect/3d/ChampionStage3D.vue): `src/components/ChampionSelect/3d/ChampionStage3D.vue`

### Post-Game

- [Post-Game View](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/views/PostgameView.vue): `src/views/PostgameView.vue`
- [Post-Game Recap](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/PostGame/PostGameScene.vue): `src/components/PostGame/PostGameScene.vue`
- [Post-Game Data](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/composables/usePostGameScreens.ts): `src/composables/usePostGameScreens.ts`
- [Post-Game Screen Routing](https://github.com/bluebottlegg/leaguebroadcast-js-client-demo/blob/main/src/components/PostGame/postgameRoutes.ts): `src/components/PostGame/postgameRoutes.ts`

### Other components

- **Broadcast Operator**
- **OBS / vMix**
- **LeagueBroadcast Server**

## Connections

- Broadcast Operator → OBS / vMix: configures source (evidence: `README.md`)
- OBS / vMix → In-Game Overlay: displays graphics (evidence: `README.md`)
- App Bootstrap → Broadcast Client: provides client (evidence: `src/main.ts`)
- App Bootstrap → Route Selection: installs router (evidence: `src/main.ts`)
- Broadcast Client → LeagueBroadcast Server: connects to
- Route Selection → Combined View: routes to (evidence: `src/router/index.ts`)
- Route Selection → In-Game Overlay: routes to (evidence: `src/router/index.ts`)
- Route Selection → Element Pages: routes to (evidence: `src/router/index.ts`)
- Route Selection → Champion Select: routes to (evidence: `src/router/index.ts`)
- Route Selection → Post-Game View: routes to (evidence: `src/router/index.ts`)
- Combined View → In-Game Overlay: layers
- In-Game Overlay → Scoreboards and Timers: renders (evidence: `src/views/OverlayView.vue`)
- In-Game Overlay → Game Information Panels: renders (evidence: `src/views/OverlayView.vue`)
- In-Game Overlay → Damage Analytics: renders (evidence: `src/views/OverlayView.vue`)
- In-Game Overlay → Damage Sidebars: renders (evidence: `src/views/OverlayView.vue`)
- In-Game Overlay → Gold Analytics: renders (evidence: `src/views/OverlayView.vue`)
- In-Game Overlay → Kill Participation: renders (evidence: `src/views/OverlayView.vue`)
- In-Game Overlay → Objective Recap: renders (evidence: `src/views/OverlayView.vue`)
- In-Game Overlay → Twitch Interactions: renders (evidence: `src/views/OverlayView.vue`)
- Damage Analytics → Damage Flow Data: builds from (evidence: `src/components/DamageFlow/DamageFlow.vue`)
- Broadcast Client → Reactive Game State: selects state (evidence: `src/composables/useIngame.ts`)
- Reactive Game State → Damage Analytics: supplies state (evidence: `src/components/DamageFlow/DamageFlow.vue`)
- Reactive Game State → Gold Analytics: supplies state (evidence: `src/components/GoldGraph/GoldGraph.vue`)
- Reactive Game State → Damage Sidebars: supplies state (evidence: `src/components/DamageSidebar/DamageSidebar.vue`)
- Reactive Game State → Kill Participation: supplies state (evidence: `src/components/KillParticipation/KillParticipation.vue`)
- Reactive Game State → Objective Recap: supplies state (evidence: `src/components/ObjectiveRecap/ObjectiveRecap.vue`)
- Reactive Game State → Twitch Interactions: supplies state (evidence: `src/components/TwitchSidebar/TwitchSidebar.vue`)
- Champion Select → 3D Champion Stage: optional 3D stage (evidence: `README.md`)
- Post-Game View → Post-Game Recap: shows recap (evidence: `README.md`)
- Post-Game Recap → Post-Game Data: loads screen data
- Post-Game Recap → Post-Game Screen Routing: selects screens
- Post-Game Data → Broadcast Client: fetches match data (evidence: `src/composables/usePostGameScreens.ts`)
