# givikuna/warframecardgame architecture

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

- Interactive diagram: https://gitdiagram.com/givikuna/warframecardgame
- Repository: https://github.com/givikuna/warframecardgame

## Overview

WarframeCardGame is a beta, turn-based card game. Players enter through the web client and a realtime server manages lobbies and matches; a match creates a board and advances turns, during which players, cards, actions, and effects resolve game state. The tree also shows deck-building and card/deck/player data modules. Those client and persistence branches are represented at subsystem level because their implementation excerpts were not provided; connections without direct evidence are omitted or marked unverified.

Main entry points: [`cgi/managers/GameManager.ts`](https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/GameManager.ts) (Match Manager), [`cgi/servers/GameServer.ts`](https://github.com/givikuna/warframecardgame/blob/main/cgi/servers/GameServer.ts) (Game Server), [`classes/Card.ts`](https://github.com/givikuna/warframecardgame/blob/main/classes/Card.ts) (Card), [`cgi/managers/LobbyManager.ts`](https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/LobbyManager.ts) (Lobby Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_realtime["Realtime Server"]
  node_server["Server Entry<br/>[server.ts]"]
  node_game_server["Game Server<br/>[GameServer.ts]"]
  node_lobby["Lobby Manager<br/>[LobbyManager.ts]"]
  node_connections["Connections"]
  node_game_manager["Match Manager<br/>[GameManager.ts]"]
end

subgraph group_runtime["Game Runtime"]
  node_game["Match State<br/>[Game.ts]"]
  node_board["Board<br/>[Board.ts]"]
  node_player_state["Player State<br/>[Player.ts]"]
  node_deck["Deck<br/>[Deck.ts]"]
  node_events["Game Events<br/>[EventManager.ts]"]
end

subgraph group_content["Game Mechanics"]
  node_card["Card<br/>[Card.ts]"]
  node_actions["Card Actions<br/>[Action.ts]"]
  node_damage["Damage Resolution<br/>[DamageInstance.ts]"]
  node_status["Status Effects<br/>[StatusEffect.ts]"]
  node_card_catalog["Card Catalog<br/>[cards.ts]"]
end

subgraph group_client["Web Client"]
  node_web_app["Web Application<br/>[App.tsx]"]
  node_game_page["Game View<br/>[GamePage.tsx]"]
  node_deck_builder["Deck Builder<br/>[DeckBuilder.tsx]"]
end

subgraph group_data["Deck And Player Data"]
  node_deck_factory["Deck Factory<br/>[DeckFactory.ts]"]
  node_deck_api["Deck API<br/>[DeckAPI.ts]"]
  node_player_api["Player API<br/>[PlayerAPI.ts]"]
end

node_player(("Player"))

node_server -->|"starts"| node_game_server
node_game_server -->|"routes to"| node_lobby
node_game_server -->|"dispatches to"| node_game_manager
node_game_server -->|"uses"| node_connections
node_lobby -->|"uses"| node_game_manager
node_lobby -->|"uses"| node_connections
node_game_manager -->|"resolves player IDs"| node_connections
node_game_manager -->|"creates"| node_game
node_game_manager -->|"initializes"| node_board
node_game -->|"advances turns"| node_board
node_game -->|"emits events"| node_events
node_board -->|"ticks players"| node_player_state
node_player_state -->|"draws and plays"| node_deck
node_player_state -->|"ticks cards"| node_card
node_card -->|"runs actions"| node_actions
node_card -->|"ticks effects"| node_status
node_card -->|"emits death event"| node_events
node_status -->|"applies damage"| node_damage
node_damage -->|"emits damage event"| node_events
node_game_manager -.->|"matches"| node_player
node_player -.->|"uses"| node_web_app
node_web_app -.->|"displays"| node_game_page
node_web_app -.->|"offers"| node_deck_builder
node_deck_builder -.->|"builds decks"| node_deck_factory
node_deck_factory -->|"loads deck data"| node_deck_api
node_deck_api -.->|"shares data layer"| node_player_api
node_deck -.->|"uses card definitions"| node_card_catalog

click node_server "https://github.com/givikuna/warframecardgame/blob/main/cgi/server.ts"
click node_game_server "https://github.com/givikuna/warframecardgame/blob/main/cgi/servers/GameServer.ts"
click node_lobby "https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/LobbyManager.ts"
click node_connections "https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/ConnectionManager.ts"
click node_game_manager "https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/GameManager.ts"
click node_game "https://github.com/givikuna/warframecardgame/blob/main/game/Game.ts"
click node_board "https://github.com/givikuna/warframecardgame/blob/main/classes/Board.ts"
click node_player_state "https://github.com/givikuna/warframecardgame/blob/main/classes/Player.ts"
click node_deck "https://github.com/givikuna/warframecardgame/blob/main/classes/Deck.ts"
click node_events "https://github.com/givikuna/warframecardgame/blob/main/game/events/EventManager.ts"
click node_card "https://github.com/givikuna/warframecardgame/blob/main/classes/Card.ts"
click node_actions "https://github.com/givikuna/warframecardgame/blob/main/classes/Action.ts"
click node_damage "https://github.com/givikuna/warframecardgame/blob/main/classes/DamageInstance.ts"
click node_status "https://github.com/givikuna/warframecardgame/blob/main/classes/StatusEffect.ts"
click node_card_catalog "https://github.com/givikuna/warframecardgame/blob/main/db/cards/cards.ts"
click node_web_app "https://github.com/givikuna/warframecardgame/blob/main/public/App.tsx"
click node_game_page "https://github.com/givikuna/warframecardgame/blob/main/public/pages/GamePage.tsx"
click node_deck_builder "https://github.com/givikuna/warframecardgame/blob/main/public/pages/DeckBuilder.tsx"
click node_deck_factory "https://github.com/givikuna/warframecardgame/blob/main/factories/DeckFactory.ts"
click node_deck_api "https://github.com/givikuna/warframecardgame/blob/main/db/decks/DeckAPI.ts"
click node_player_api "https://github.com/givikuna/warframecardgame/blob/main/db/players/PlayerAPI.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_server,node_game_server,node_lobby,node_connections,node_game_manager toneBlue
class node_game,node_board,node_player_state,node_deck,node_events toneAmber
class node_card,node_actions,node_damage,node_status,node_card_catalog toneMint
class node_web_app,node_game_page,node_deck_builder toneRose
class node_deck_factory,node_deck_api,node_player_api,node_player toneIndigo
```

## Components

### Realtime Server

- [Server Entry](https://github.com/givikuna/warframecardgame/blob/main/cgi/server.ts): `cgi/server.ts`
- [Game Server](https://github.com/givikuna/warframecardgame/blob/main/cgi/servers/GameServer.ts): `cgi/servers/GameServer.ts`
- [Lobby Manager](https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/LobbyManager.ts): `cgi/managers/LobbyManager.ts`
- [Connections](https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/ConnectionManager.ts): `cgi/managers/ConnectionManager.ts`
- [Match Manager](https://github.com/givikuna/warframecardgame/blob/main/cgi/managers/GameManager.ts): `cgi/managers/GameManager.ts`

### Game Runtime

- [Match State](https://github.com/givikuna/warframecardgame/blob/main/game/Game.ts): `game/Game.ts`
- [Board](https://github.com/givikuna/warframecardgame/blob/main/classes/Board.ts): `classes/Board.ts`
- [Player State](https://github.com/givikuna/warframecardgame/blob/main/classes/Player.ts): `classes/Player.ts`
- [Deck](https://github.com/givikuna/warframecardgame/blob/main/classes/Deck.ts): `classes/Deck.ts`
- [Game Events](https://github.com/givikuna/warframecardgame/blob/main/game/events/EventManager.ts): `game/events/EventManager.ts`

### Game Mechanics

- [Card](https://github.com/givikuna/warframecardgame/blob/main/classes/Card.ts): `classes/Card.ts`
- [Card Actions](https://github.com/givikuna/warframecardgame/blob/main/classes/Action.ts): `classes/Action.ts`
- [Damage Resolution](https://github.com/givikuna/warframecardgame/blob/main/classes/DamageInstance.ts): `classes/DamageInstance.ts`
- [Status Effects](https://github.com/givikuna/warframecardgame/blob/main/classes/StatusEffect.ts): `classes/StatusEffect.ts`
- [Card Catalog](https://github.com/givikuna/warframecardgame/blob/main/db/cards/cards.ts): `db/cards/cards.ts`

### Web Client

- [Web Application](https://github.com/givikuna/warframecardgame/blob/main/public/App.tsx): `public/App.tsx`
- [Game View](https://github.com/givikuna/warframecardgame/blob/main/public/pages/GamePage.tsx): `public/pages/GamePage.tsx`
- [Deck Builder](https://github.com/givikuna/warframecardgame/blob/main/public/pages/DeckBuilder.tsx): `public/pages/DeckBuilder.tsx`

### Deck And Player Data

- [Deck Factory](https://github.com/givikuna/warframecardgame/blob/main/factories/DeckFactory.ts): `factories/DeckFactory.ts`
- [Deck API](https://github.com/givikuna/warframecardgame/blob/main/db/decks/DeckAPI.ts): `db/decks/DeckAPI.ts`
- [Player API](https://github.com/givikuna/warframecardgame/blob/main/db/players/PlayerAPI.ts): `db/players/PlayerAPI.ts`

### Other components

- **Player**

## Connections

- Server Entry → Game Server: starts (evidence: `cgi/server.ts`)
- Game Server → Lobby Manager: routes to (evidence: `cgi/servers/GameServer.ts`)
- Game Server → Match Manager: dispatches to (evidence: `cgi/servers/GameServer.ts`)
- Game Server → Connections: uses (evidence: `cgi/servers/GameServer.ts`)
- Lobby Manager → Match Manager: uses (evidence: `cgi/managers/LobbyManager.ts`)
- Lobby Manager → Connections: uses (evidence: `cgi/managers/LobbyManager.ts`)
- Match Manager → Connections: resolves player IDs (evidence: `cgi/managers/GameManager.ts`)
- Match Manager → Match State: creates (evidence: `cgi/managers/GameManager.ts`)
- Match Manager → Board: initializes (evidence: `cgi/managers/GameManager.ts`)
- Match State → Board: advances turns (evidence: `game/Game.ts`)
- Match State → Game Events: emits events (evidence: `game/Game.ts`)
- Board → Player State: ticks players (evidence: `classes/Board.ts`)
- Player State → Deck: draws and plays (evidence: `classes/Player.ts`)
- Player State → Card: ticks cards (evidence: `classes/Player.ts`)
- Card → Card Actions: runs actions (evidence: `classes/Card.ts`)
- Card → Status Effects: ticks effects (evidence: `classes/Card.ts`)
- Card → Game Events: emits death event (evidence: `classes/Card.ts`)
- Status Effects → Damage Resolution: applies damage (evidence: `classes/StatusEffect.ts`)
- Damage Resolution → Game Events: emits damage event (evidence: `classes/DamageInstance.ts`)
- Match Manager → Player: matches
- Player → Web Application: uses
- Web Application → Game View: displays
- Web Application → Deck Builder: offers
- Deck Builder → Deck Factory: builds decks
- Deck Factory → Deck API: loads deck data (evidence: `factories/DeckFactory.ts`)
- Deck API → Player API: shares data layer
- Deck → Card Catalog: uses card definitions
