How valospectra/spectra-frontend works
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: app-routing.module.ts Application routes · match-overlay.component.ts Match overlay · dataModel.service.ts Match data model · SocketService.ts Socket transport
Components 23
State and transport
- Match data model
src/app/services/dataModel.service.ts - Socket transport
src/app/services/SocketService.ts - Match data types
src/app/services/Types.ts - Runtime configuration
src/app/shared/config.ts - Camera stream service
src/app/services/playercamStream.service.ts - Application routes
src/app/app-routing.module.ts
Match overlay
- Match overlay
src/app/overlays/match-overlay/match-overlay.component.ts
Standalone overlays
- Map-ban overlay
src/app/overlays/mapban-overlay/mapban-overlay.component.ts - Team and map breakdowns
src/app/overlays/team-breakdown/team-breakdown.ts - Agent selection overlay
src/app/overlays/agent-select-overlay/agent-select-overlay.component.ts - Timeout overlay
src/app/components/common/timeout/timeout.component.ts - Toast overlay
src/app/components/shopping/toast/toast-component.ts
Overlay components
- Scoreboard
src/app/components/shopping/scoreboard/scoreboard.component.ts - Combat views
src/app/components/combat/player-list/player-list.component.ts - Combat player cards
src/app/components/combat/player-combat-card/player-combat-card.component.ts - Player cameras
src/app/components/combat/playercams/playercams.component.ts - Map-ban map view
src/app/components/mapban/mapban-map/mapban-map.component.ts
Shared presentation
- Stats API mapping
src/app/components/breakdown/StatsApiMapping.ts - Translation helpers
src/app/services/i18nHelper.ts
Other components
- Spectator observer
- Spectra Server
- Overlay viewers
- VDO.Ninja
Connections 24
- Spectator observer → Spectra Server: sends game data
- Spectra Server → Socket transport: streams match state
- Match data model → Socket transport: connects and subscribes
src/app/services/dataModel.service.ts - Socket transport → Match data model: dispatches updates
src/app/services/SocketService.ts - Match data model → Runtime configuration: reads endpoints
src/app/services/dataModel.service.ts - Match data model → Match data types: uses data contracts
src/app/services/dataModel.service.ts - Overlay viewers → Match overlay: views overlay
- Match overlay → Match data model: reads match state
src/app/overlays/match-overlay/match-overlay.component.ts - Match overlay → Scoreboard: renders
src/app/overlays/match-overlay/match-overlay.component.ts - Match overlay → Combat views: renders
src/app/overlays/match-overlay/match-overlay.component.ts - Combat views → Combat player cards: uses cards
src/app/components/combat/player-list/player-list.component.ts - Match overlay → Player cameras: renders
src/app/overlays/match-overlay/match-overlay.component.ts - Player cameras → Camera stream service: requests streams
src/app/components/combat/playercams/playercams.component.ts - Camera stream service → Match data model: reads player data
src/app/services/playercamStream.service.ts - Camera stream service → VDO.Ninja: builds stream URLs
src/app/services/playercamStream.service.ts - Application routes → Match overlay: routes match views
src/app/app-routing.module.ts - Application routes → Map-ban overlay: routes map bans
src/app/app-routing.module.ts - Map-ban overlay → Socket transport: connects map-ban feed
src/app/overlays/mapban-overlay/mapban-overlay.component.ts - Map-ban overlay → Map-ban map view: renders map view
src/app/overlays/mapban-overlay/mapban-overlay.component.ts - Application routes → Team and map breakdowns: routes breakdowns
src/app/app-routing.module.ts - Team and map breakdowns → Stats API mapping: uses stats mapping
src/app/overlays/team-breakdown/team-breakdown.ts - Application routes → Agent selection overlay: routes agent selection
src/app/app-routing.module.ts - Application routes → Timeout overlay: routes timeout
src/app/app-routing.module.ts - Application routes → Toast overlay: routes toast
src/app/app-routing.module.ts