# erriswheel/net-crisis-phaser architecture

> Architecture diagram of the GitHub repository erriswheel/net-crisis-phaser, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/erriswheel/net-crisis-phaser
- Repository: https://github.com/erriswheel/net-crisis-phaser

## Overview

Net Crisis is a browser-based, multiplayer pandemic-themed game built with Phaser. Players can create or join a room, select a character and ready up in a lobby, then take turns performing actions on a network of nodes as the game state changes; a game-over scene presents the ending. The main internal layers are the Phaser scenes, board/HUD presentation, and SmartFoxServer event handling. The README describes a generic Phaser template, so game capabilities and relationships here rely on the supplied source index and excerpts; unsampled links are omitted where evidence is insufficient.

Main entry points: [`src/game/scenes/Game.ts`](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Game.ts) (Gameplay scene), [`src/game/network/socket.ts`](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/socket.ts) (SmartFox client), [`src/game/main.ts`](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/main.ts) (Game setup), [`src/game/scenes/JoinGame.ts`](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/JoinGame.ts) (Join room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scenes["Game scenes"]
  node_app["App bootstrap<br/>[main.ts]"]
  node_game_setup["Game setup<br/>[main.ts]"]
  node_boot["Boot scene<br/>[Boot.ts]"]
  node_preloader["Asset preload<br/>[Preloader.ts]"]
  node_main_menu["Main menu<br/>[MainMenu.ts]"]
  node_create_game["Create room<br/>[CreateGame.ts]"]
  node_join_game["Join room<br/>[JoinGame.ts]"]
  node_lobby["Room lobby<br/>[Lobby.ts]"]
  node_game_scene["Gameplay scene<br/>[Game.ts]"]
  node_game_over["Game over<br/>[GameOver.ts]"]
end

subgraph group_presentation["Game presentation"]
  node_board["Game board<br/>[board.ts]"]
  node_node["Board node<br/>[node.ts]"]
  node_edge["Board edge<br/>[edge.ts]"]
  node_player_token["Player token<br/>[player.ts]"]
  node_hud["Game HUD<br/>[hud.ts]"]
  node_gameover_modal["Game-over dialog<br/>[gameoverModal.ts]"]
  node_confirm_modal["Action dialog<br/>[modal.ts]"]
  node_ui_helpers["Input helpers<br/>[uiHelpers.ts]"]
  node_text_button["Text button<br/>[TextButton.ts]"]
end

subgraph group_network["Multiplayer networking"]
  node_socket["SmartFox client<br/>[socket.ts]"]
  node_create_events["Room creation events"]
  node_join_events["Room join events<br/>[joinGameEvent.ts]"]
  node_lobby_events["Lobby events<br/>[lobbyEvents.ts]"]
  node_game_events["Game events<br/>[gameEvents.ts]"]
  node_event_types["Server event types<br/>[sfs2x-event.ts]"]
end

subgraph group_configuration["Board configuration"]
  node_sea_config["Sea board layout<br/>[sea.ts]"]
  node_cluster_config["Cluster board layout<br/>[cluster-web.ts]"]
  node_config_types["Board config types<br/>[type.ts]"]
end

node_player(("Player"))

node_player -.->|"starts game"| node_app
node_app -->|"starts"| node_game_setup
node_game_setup -->|"registers scene"| node_boot
node_game_setup -->|"registers scene"| node_preloader
node_game_setup -->|"registers scene"| node_main_menu
node_game_setup -->|"registers scene"| node_create_game
node_game_setup -->|"registers scene"| node_join_game
node_game_setup -->|"registers scene"| node_lobby
node_game_setup -->|"registers scene"| node_game_scene
node_game_setup -->|"registers scene"| node_game_over
node_create_game -->|"connects via"| node_socket
node_create_game -->|"delegates to"| node_create_events
node_join_game -->|"creates inputs"| node_ui_helpers
node_join_game -->|"uses"| node_text_button
node_join_game -->|"delegates to"| node_join_events
node_join_game -->|"connects via"| node_socket
node_lobby -->|"creates handler"| node_lobby_events
node_lobby -->|"updates room state"| node_socket
node_lobby -->|"uses"| node_text_button
node_game_scene -->|"creates"| node_board
node_game_scene -->|"creates"| node_hud
node_game_scene -->|"creates"| node_game_events
node_game_scene -->|"creates"| node_confirm_modal
node_game_scene -->|"uses"| node_gameover_modal
node_game_scene -->|"uses"| node_node
node_game_scene -->|"reads room state"| node_socket
node_game_scene -->|"uses layout"| node_sea_config
node_game_scene -->|"uses layout"| node_cluster_config
node_board -->|"creates"| node_node
node_board -->|"creates"| node_edge
node_board -->|"creates"| node_player_token
node_board -->|"reads room state"| node_socket
node_node -->|"positions"| node_player_token
node_hud -->|"creates"| node_text_button
node_hud -->|"reads player state"| node_socket
node_game_events -->|"uses"| node_socket
node_game_events -->|"updates scene"| node_game_scene
node_game_events -->|"uses"| node_gameover_modal
node_create_events -->|"uses"| node_socket
node_create_events -->|"updates scene"| node_create_game
node_join_events -->|"uses"| node_socket
node_join_events -->|"updates scene"| node_join_game
node_lobby_events -->|"uses"| node_socket
node_lobby_events -->|"updates scene"| node_lobby
node_socket -->|"types events"| node_event_types
node_sea_config -->|"uses types"| node_config_types
node_cluster_config -->|"uses types"| node_config_types

click node_app "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/main.ts"
click node_game_setup "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/main.ts"
click node_boot "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Boot.ts"
click node_preloader "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Preloader.ts"
click node_main_menu "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/MainMenu.ts"
click node_create_game "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/CreateGame.ts"
click node_join_game "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/JoinGame.ts"
click node_lobby "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Lobby.ts"
click node_game_scene "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Game.ts"
click node_game_over "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/GameOver.ts"
click node_board "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/board.ts"
click node_node "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/node.ts"
click node_edge "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/edge.ts"
click node_player_token "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/player.ts"
click node_hud "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/hud.ts"
click node_gameover_modal "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/gameoverModal.ts"
click node_confirm_modal "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/modal.ts"
click node_socket "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/socket.ts"
click node_create_events "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/createGameEvents.ts"
click node_join_events "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/joinGameEvent.ts"
click node_lobby_events "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/lobbyEvents.ts"
click node_game_events "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/gameEvents.ts"
click node_event_types "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/types/sfs2x-event.ts"
click node_sea_config "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/configs/sea.ts"
click node_cluster_config "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/configs/cluster-web.ts"
click node_config_types "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/configs/type.ts"
click node_ui_helpers "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/helpers/uiHelpers.ts"
click node_text_button "https://github.com/erriswheel/net-crisis-phaser/blob/main/src/ui/TextButton.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_app,node_game_setup,node_boot,node_preloader,node_main_menu,node_create_game,node_join_game,node_lobby,node_game_scene,node_game_over toneBlue
class node_board,node_node,node_edge,node_player_token,node_hud,node_gameover_modal,node_confirm_modal,node_ui_helpers,node_text_button toneAmber
class node_socket,node_create_events,node_join_events,node_lobby_events,node_game_events,node_event_types toneMint
class node_sea_config,node_cluster_config,node_config_types toneRose
class node_player toneIndigo
```

## Components

### Game scenes

- [App bootstrap](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/main.ts): `src/main.ts`
- [Game setup](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/main.ts): `src/game/main.ts`
- [Boot scene](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Boot.ts): `src/game/scenes/Boot.ts`
- [Asset preload](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Preloader.ts): `src/game/scenes/Preloader.ts`
- [Main menu](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/MainMenu.ts): `src/game/scenes/MainMenu.ts`
- [Create room](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/CreateGame.ts): `src/game/scenes/CreateGame.ts`
- [Join room](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/JoinGame.ts): `src/game/scenes/JoinGame.ts`
- [Room lobby](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Lobby.ts): `src/game/scenes/Lobby.ts`
- [Gameplay scene](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/Game.ts): `src/game/scenes/Game.ts`
- [Game over](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/scenes/GameOver.ts): `src/game/scenes/GameOver.ts`

### Game presentation

- [Game board](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/board.ts): `src/game/containers/board.ts`
- [Board node](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/node.ts): `src/game/containers/node.ts`
- [Board edge](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/edge.ts): `src/game/containers/edge.ts`
- [Player token](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/player.ts): `src/game/containers/player.ts`
- [Game HUD](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/hud.ts): `src/game/containers/hud.ts`
- [Game-over dialog](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/gameoverModal.ts): `src/game/containers/gameoverModal.ts`
- [Action dialog](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/containers/modal.ts): `src/game/containers/modal.ts`
- [Input helpers](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/helpers/uiHelpers.ts): `src/helpers/uiHelpers.ts`
- [Text button](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/ui/TextButton.ts): `src/ui/TextButton.ts`

### Multiplayer networking

- [SmartFox client](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/socket.ts): `src/game/network/socket.ts`
- [Room creation events](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/createGameEvents.ts): `src/game/network/createGameEvents.ts`
- [Room join events](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/joinGameEvent.ts): `src/game/network/joinGameEvent.ts`
- [Lobby events](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/lobbyEvents.ts): `src/game/network/lobbyEvents.ts`
- [Game events](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/network/gameEvents.ts): `src/game/network/gameEvents.ts`
- [Server event types](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/types/sfs2x-event.ts): `src/types/sfs2x-event.ts`

### Board configuration

- [Sea board layout](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/configs/sea.ts): `src/game/configs/sea.ts`
- [Cluster board layout](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/configs/cluster-web.ts): `src/game/configs/cluster-web.ts`
- [Board config types](https://github.com/erriswheel/net-crisis-phaser/blob/main/src/game/configs/type.ts): `src/game/configs/type.ts`

### Other components

- **Player**

## Connections

- Player → App bootstrap: starts game
- App bootstrap → Game setup: starts (evidence: `src/main.ts`)
- Game setup → Boot scene: registers scene (evidence: `src/game/main.ts`)
- Game setup → Asset preload: registers scene (evidence: `src/game/main.ts`)
- Game setup → Main menu: registers scene (evidence: `src/game/main.ts`)
- Game setup → Create room: registers scene (evidence: `src/game/main.ts`)
- Game setup → Join room: registers scene (evidence: `src/game/main.ts`)
- Game setup → Room lobby: registers scene (evidence: `src/game/main.ts`)
- Game setup → Gameplay scene: registers scene (evidence: `src/game/main.ts`)
- Game setup → Game over: registers scene (evidence: `src/game/main.ts`)
- Create room → SmartFox client: connects via (evidence: `src/game/scenes/CreateGame.ts`)
- Create room → Room creation events: delegates to (evidence: `src/game/scenes/CreateGame.ts`)
- Join room → Input helpers: creates inputs (evidence: `src/game/scenes/JoinGame.ts`)
- Join room → Text button: uses (evidence: `src/game/scenes/JoinGame.ts`)
- Join room → Room join events: delegates to (evidence: `src/game/scenes/JoinGame.ts`)
- Join room → SmartFox client: connects via (evidence: `src/game/scenes/JoinGame.ts`)
- Room lobby → Lobby events: creates handler (evidence: `src/game/scenes/Lobby.ts`)
- Room lobby → SmartFox client: updates room state (evidence: `src/game/scenes/Lobby.ts`)
- Room lobby → Text button: uses (evidence: `src/game/scenes/Lobby.ts`)
- Gameplay scene → Game board: creates (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → Game HUD: creates (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → Game events: creates (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → Action dialog: creates (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → Game-over dialog: uses (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → Board node: uses (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → SmartFox client: reads room state (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → Sea board layout: uses layout (evidence: `src/game/scenes/Game.ts`)
- Gameplay scene → Cluster board layout: uses layout (evidence: `src/game/scenes/Game.ts`)
- Game board → Board node: creates (evidence: `src/game/containers/board.ts`)
- Game board → Board edge: creates (evidence: `src/game/containers/board.ts`)
- Game board → Player token: creates (evidence: `src/game/containers/board.ts`)
- Game board → SmartFox client: reads room state (evidence: `src/game/containers/board.ts`)
- Board node → Player token: positions (evidence: `src/game/containers/node.ts`)
- Game HUD → Text button: creates (evidence: `src/game/containers/hud.ts`)
- Game HUD → SmartFox client: reads player state (evidence: `src/game/containers/hud.ts`)
- Game events → SmartFox client: uses (evidence: `src/game/network/gameEvents.ts`)
- Game events → Gameplay scene: updates scene (evidence: `src/game/network/gameEvents.ts`)
- Game events → Game-over dialog: uses (evidence: `src/game/network/gameEvents.ts`)
- Room creation events → SmartFox client: uses (evidence: `src/game/network/createGameEvents.ts`)
- Room creation events → Create room: updates scene (evidence: `src/game/network/createGameEvents.ts`)
- Room join events → SmartFox client: uses (evidence: `src/game/network/joinGameEvent.ts`)
- Room join events → Join room: updates scene (evidence: `src/game/network/joinGameEvent.ts`)
- Lobby events → SmartFox client: uses (evidence: `src/game/network/lobbyEvents.ts`)
- Lobby events → Room lobby: updates scene (evidence: `src/game/network/lobbyEvents.ts`)
- SmartFox client → Server event types: types events (evidence: `src/game/network/socket.ts`)
- Sea board layout → Board config types: uses types (evidence: `src/game/configs/sea.ts`)
- Cluster board layout → Board config types: uses types (evidence: `src/game/configs/cluster-web.ts`)
