# valospectra/spectra-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/valospectra/spectra-frontend
- Repository: https://github.com/valospectra/spectra-frontend

## Overview

ValoSpectra Frontend is a Valorant tournament-overlay client. Its main workflow receives match updates from the Spectra Server, maintains shared match state, and renders that state through the match overlay and its scoreboard, combat, and match-information views. Separate routes provide map bans, player cameras, agent selection, and match/map breakdowns; the README also describes the broader observer-client-to-server data flow. The graph follows the shown routes and service wiring; breakdown internals and some auxiliary components were not sampled, so their connections are limited to documented or indexed relationships.

Main entry points: [`src/app/app-routing.module.ts`](https://github.com/valospectra/spectra-frontend/blob/main/src/app/app-routing.module.ts) (Application routes), [`src/app/overlays/match-overlay/match-overlay.component.ts`](https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/match-overlay/match-overlay.component.ts) (Match overlay), [`src/app/services/dataModel.service.ts`](https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/dataModel.service.ts) (Match data model), [`src/app/services/SocketService.ts`](https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/SocketService.ts) (Socket transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_state["State and transport"]
  node_matchdata["Match data model"]
  node_socket["Socket transport<br/>[SocketService.ts]"]
  node_types["Match data types<br/>[Types.ts]"]
  node_config["Runtime configuration<br/>[config.ts]"]
  node_camservice["Camera stream service"]
  node_routes["Application routes"]
end

subgraph group_match["Match overlay"]
  node_matchroute["Match overlay"]
end

subgraph group_features["Standalone overlays"]
  node_mapban["Map-ban overlay"]
  node_breakdowns["Team and map breakdowns<br/>[team-breakdown.ts]"]
  node_agentselect["Agent selection overlay"]
  node_timeout["Timeout overlay"]
  node_toast["Toast overlay<br/>[toast-component.ts]"]
end

subgraph group_views["Overlay components"]
  node_scoreboard["Scoreboard"]
  node_combat["Combat views"]
  node_playercards["Combat player cards"]
  node_cams["Player cameras"]
  node_mapview["Map-ban map view"]
end

subgraph group_support["Shared presentation"]
  node_statsmapping["Stats API mapping<br/>[StatsApiMapping.ts]"]
  node_i18n["Translation helpers<br/>[i18nHelper.ts]"]
end

node_observer(("Spectator observer"))
node_server["Spectra Server"]
node_viewers(("Overlay viewers"))
node_vdo["VDO.Ninja"]

node_observer -->|"sends game data"| node_server
node_server -->|"streams match state"| node_socket
node_matchdata -->|"connects and subscribes"| node_socket
node_socket -->|"dispatches updates"| node_matchdata
node_matchdata -->|"reads endpoints"| node_config
node_matchdata -->|"uses data contracts"| node_types
node_viewers -.->|"views overlay"| node_matchroute
node_matchroute -->|"reads match state"| node_matchdata
node_matchroute -->|"renders"| node_scoreboard
node_matchroute -->|"renders"| node_combat
node_combat -->|"uses cards"| node_playercards
node_matchroute -->|"renders"| node_cams
node_cams -->|"requests streams"| node_camservice
node_camservice -->|"reads player data"| node_matchdata
node_camservice -->|"builds stream URLs"| node_vdo
node_routes -->|"routes match views"| node_matchroute
node_routes -->|"routes map bans"| node_mapban
node_mapban -->|"connects map-ban feed"| node_socket
node_mapban -->|"renders map view"| node_mapview
node_routes -->|"routes breakdowns"| node_breakdowns
node_breakdowns -->|"uses stats mapping"| node_statsmapping
node_routes -->|"routes agent selection"| node_agentselect
node_routes -->|"routes timeout"| node_timeout
node_routes -->|"routes toast"| node_toast

click node_matchdata "https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/dataModel.service.ts"
click node_socket "https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/SocketService.ts"
click node_types "https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/Types.ts"
click node_config "https://github.com/valospectra/spectra-frontend/blob/main/src/app/shared/config.ts"
click node_matchroute "https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/match-overlay/match-overlay.component.ts"
click node_scoreboard "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/shopping/scoreboard/scoreboard.component.ts"
click node_combat "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/combat/player-list/player-list.component.ts"
click node_playercards "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/combat/player-combat-card/player-combat-card.component.ts"
click node_cams "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/combat/playercams/playercams.component.ts"
click node_camservice "https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/playercamStream.service.ts"
click node_mapban "https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/mapban-overlay/mapban-overlay.component.ts"
click node_mapview "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/mapban/mapban-map/mapban-map.component.ts"
click node_breakdowns "https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/team-breakdown/team-breakdown.ts"
click node_statsmapping "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/breakdown/StatsApiMapping.ts"
click node_agentselect "https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/agent-select-overlay/agent-select-overlay.component.ts"
click node_timeout "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/common/timeout/timeout.component.ts"
click node_toast "https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/shopping/toast/toast-component.ts"
click node_i18n "https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/i18nHelper.ts"
click node_routes "https://github.com/valospectra/spectra-frontend/blob/main/src/app/app-routing.module.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_matchdata,node_socket,node_types,node_config,node_camservice,node_routes,node_viewers toneBlue
class node_matchroute toneAmber
class node_mapban,node_breakdowns,node_agentselect,node_timeout,node_toast,node_observer,node_server toneMint
class node_scoreboard,node_combat,node_playercards,node_cams,node_mapview toneRose
class node_statsmapping,node_i18n,node_vdo toneIndigo
```

## Components

### State and transport

- [Match data model](https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/dataModel.service.ts): `src/app/services/dataModel.service.ts`
- [Socket transport](https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/SocketService.ts): `src/app/services/SocketService.ts`
- [Match data types](https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/Types.ts): `src/app/services/Types.ts`
- [Runtime configuration](https://github.com/valospectra/spectra-frontend/blob/main/src/app/shared/config.ts): `src/app/shared/config.ts`
- [Camera stream service](https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/playercamStream.service.ts): `src/app/services/playercamStream.service.ts`
- [Application routes](https://github.com/valospectra/spectra-frontend/blob/main/src/app/app-routing.module.ts): `src/app/app-routing.module.ts`

### Match overlay

- [Match overlay](https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/match-overlay/match-overlay.component.ts): `src/app/overlays/match-overlay/match-overlay.component.ts`

### Standalone overlays

- [Map-ban overlay](https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/mapban-overlay/mapban-overlay.component.ts): `src/app/overlays/mapban-overlay/mapban-overlay.component.ts`
- [Team and map breakdowns](https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/team-breakdown/team-breakdown.ts): `src/app/overlays/team-breakdown/team-breakdown.ts`
- [Agent selection overlay](https://github.com/valospectra/spectra-frontend/blob/main/src/app/overlays/agent-select-overlay/agent-select-overlay.component.ts): `src/app/overlays/agent-select-overlay/agent-select-overlay.component.ts`
- [Timeout overlay](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/common/timeout/timeout.component.ts): `src/app/components/common/timeout/timeout.component.ts`
- [Toast overlay](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/shopping/toast/toast-component.ts): `src/app/components/shopping/toast/toast-component.ts`

### Overlay components

- [Scoreboard](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/shopping/scoreboard/scoreboard.component.ts): `src/app/components/shopping/scoreboard/scoreboard.component.ts`
- [Combat views](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/combat/player-list/player-list.component.ts): `src/app/components/combat/player-list/player-list.component.ts`
- [Combat player cards](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/combat/player-combat-card/player-combat-card.component.ts): `src/app/components/combat/player-combat-card/player-combat-card.component.ts`
- [Player cameras](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/combat/playercams/playercams.component.ts): `src/app/components/combat/playercams/playercams.component.ts`
- [Map-ban map view](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/mapban/mapban-map/mapban-map.component.ts): `src/app/components/mapban/mapban-map/mapban-map.component.ts`

### Shared presentation

- [Stats API mapping](https://github.com/valospectra/spectra-frontend/blob/main/src/app/components/breakdown/StatsApiMapping.ts): `src/app/components/breakdown/StatsApiMapping.ts`
- [Translation helpers](https://github.com/valospectra/spectra-frontend/blob/main/src/app/services/i18nHelper.ts): `src/app/services/i18nHelper.ts`

### Other components

- **Spectator observer**
- **Spectra Server**
- **Overlay viewers**
- **VDO.Ninja**

## Connections

- Spectator observer → Spectra Server: sends game data
- Spectra Server → Socket transport: streams match state
- Match data model → Socket transport: connects and subscribes (evidence: `src/app/services/dataModel.service.ts`)
- Socket transport → Match data model: dispatches updates (evidence: `src/app/services/SocketService.ts`)
- Match data model → Runtime configuration: reads endpoints (evidence: `src/app/services/dataModel.service.ts`)
- Match data model → Match data types: uses data contracts (evidence: `src/app/services/dataModel.service.ts`)
- Overlay viewers → Match overlay: views overlay
- Match overlay → Match data model: reads match state (evidence: `src/app/overlays/match-overlay/match-overlay.component.ts`)
- Match overlay → Scoreboard: renders (evidence: `src/app/overlays/match-overlay/match-overlay.component.ts`)
- Match overlay → Combat views: renders (evidence: `src/app/overlays/match-overlay/match-overlay.component.ts`)
- Combat views → Combat player cards: uses cards (evidence: `src/app/components/combat/player-list/player-list.component.ts`)
- Match overlay → Player cameras: renders (evidence: `src/app/overlays/match-overlay/match-overlay.component.ts`)
- Player cameras → Camera stream service: requests streams (evidence: `src/app/components/combat/playercams/playercams.component.ts`)
- Camera stream service → Match data model: reads player data (evidence: `src/app/services/playercamStream.service.ts`)
- Camera stream service → VDO.Ninja: builds stream URLs (evidence: `src/app/services/playercamStream.service.ts`)
- Application routes → Match overlay: routes match views (evidence: `src/app/app-routing.module.ts`)
- Application routes → Map-ban overlay: routes map bans (evidence: `src/app/app-routing.module.ts`)
- Map-ban overlay → Socket transport: connects map-ban feed (evidence: `src/app/overlays/mapban-overlay/mapban-overlay.component.ts`)
- Map-ban overlay → Map-ban map view: renders map view (evidence: `src/app/overlays/mapban-overlay/mapban-overlay.component.ts`)
- Application routes → Team and map breakdowns: routes breakdowns (evidence: `src/app/app-routing.module.ts`)
- Team and map breakdowns → Stats API mapping: uses stats mapping (evidence: `src/app/overlays/team-breakdown/team-breakdown.ts`)
- Application routes → Agent selection overlay: routes agent selection (evidence: `src/app/app-routing.module.ts`)
- Application routes → Timeout overlay: routes timeout (evidence: `src/app/app-routing.module.ts`)
- Application routes → Toast overlay: routes toast (evidence: `src/app/app-routing.module.ts`)
