# geoff-jiang/chess2 architecture

> Architecture diagram of the GitHub repository geoff-jiang/chess2, 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/geoff-jiang/chess2
- Repository: https://github.com/geoff-jiang/chess2

## Overview

Chess Without Borders is a browser game combining standard chess with a finite hyperbolic board, plus local play and private two-player rooms. The main workflow runs from player input through the browser controller to game rules, then renders the updated board and move guidance; online actions are validated and broadcast by the room server. Geometry generation and curved movement form the core rules layer, while view modules project and present that geometry. README documents capabilities whose implementation is not fully sampled; those links are included only where documentation supports them.

Main entry points: [`src/view/board-view.ts`](https://github.com/geoff-jiang/chess2/blob/main/src/view/board-view.ts) (Board renderer), [`src/main.ts`](https://github.com/geoff-jiang/chess2/blob/main/src/main.ts) (Game controller), [`src/shared/game.ts`](https://github.com/geoff-jiang/chess2/blob/main/src/shared/game.ts) (Match engine), [`src/shared/geometry.ts`](https://github.com/geoff-jiang/chess2/blob/main/src/shared/geometry.ts) (Arena and anchors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser game"]
  node_controller["Game controller<br/>[main.ts]"]
  node_board["Board renderer<br/>[board-view.ts]"]
  node_projection["Hyperbolic display"]
  node_camera["Camera fit<br/>[camera-fit.ts]"]
  node_theme["Board theme<br/>[board-theme.ts]"]
  node_moveguide["Move explanation"]
  node_labels["Labels<br/>[labels.ts]"]
end

subgraph group_rules["Match rules"]
  node_engine["Match engine<br/>[game.ts]"]
  node_types["Game protocol types<br/>[game-types.ts]"]
  node_curvedmoves["Curved movement<br/>[curvature-moves.ts]"]
  node_standard["Standard chess adapter<br/>[standard-chess.ts]"]
  node_chessjs["chess.js"]
end

subgraph group_arena["Board geometry"]
  node_geometry["Arena and anchors<br/>[geometry.ts]"]
end

subgraph group_rooms["Online rooms"]
  node_roomsrv["Room server<br/>[index.ts]"]
end

node_player(("Player"))
node_opponent(("Other player"))

node_player -->|"plays through"| node_controller
node_controller -->|"requests moves"| node_engine
node_controller -->|"loads FEN"| node_standard
node_controller -->|"reads arena"| node_geometry
node_controller -->|"updates view"| node_board
node_controller -->|"explains routes"| node_moveguide
node_controller -->|"exchanges room actions"| node_roomsrv
node_board -->|"reads match state"| node_engine
node_board -->|"renders tiles"| node_geometry
node_board -->|"projects tiles"| node_projection
node_board -->|"fits view"| node_camera
node_board -->|"shows pawn heading"| node_curvedmoves
node_board -->|"uses theme"| node_theme
node_board -->|"labels pieces"| node_labels
node_moveguide -->|"names tiles"| node_geometry
node_moveguide -->|"formats text"| node_labels
node_engine -->|"uses arena"| node_geometry
node_engine -->|"generates curved moves"| node_curvedmoves
node_engine -->|"adapts flat positions"| node_standard
node_engine -->|"uses state types"| node_types
node_curvedmoves -->|"traverses edges"| node_geometry
node_curvedmoves -->|"uses move types"| node_types
node_standard -->|"maps chess squares"| node_geometry
node_standard -->|"uses game types"| node_types
node_standard -->|"adapts positions"| node_chessjs
node_roomsrv -->|"validates actions"| node_engine
node_roomsrv -->|"broadcasts snapshots"| node_opponent

click node_controller "https://github.com/geoff-jiang/chess2/blob/main/src/main.ts"
click node_board "https://github.com/geoff-jiang/chess2/blob/main/src/view/board-view.ts"
click node_projection "https://github.com/geoff-jiang/chess2/blob/main/src/view/hyperbolic-display.ts"
click node_camera "https://github.com/geoff-jiang/chess2/blob/main/src/view/camera-fit.ts"
click node_theme "https://github.com/geoff-jiang/chess2/blob/main/src/view/board-theme.ts"
click node_moveguide "https://github.com/geoff-jiang/chess2/blob/main/src/view/move-explanation.ts"
click node_labels "https://github.com/geoff-jiang/chess2/blob/main/src/shared/labels.ts"
click node_engine "https://github.com/geoff-jiang/chess2/blob/main/src/shared/game.ts"
click node_types "https://github.com/geoff-jiang/chess2/blob/main/src/shared/game-types.ts"
click node_curvedmoves "https://github.com/geoff-jiang/chess2/blob/main/src/shared/curvature-moves.ts"
click node_standard "https://github.com/geoff-jiang/chess2/blob/main/src/shared/standard-chess.ts"
click node_geometry "https://github.com/geoff-jiang/chess2/blob/main/src/shared/geometry.ts"
click node_roomsrv "https://github.com/geoff-jiang/chess2/blob/main/src/server/index.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_controller,node_board,node_projection,node_camera,node_theme,node_moveguide,node_labels toneBlue
class node_engine,node_types,node_curvedmoves,node_standard,node_chessjs toneAmber
class node_geometry toneMint
class node_roomsrv toneRose
class node_player,node_opponent toneIndigo
```

## Components

### Browser game

- [Game controller](https://github.com/geoff-jiang/chess2/blob/main/src/main.ts): `src/main.ts`
- [Board renderer](https://github.com/geoff-jiang/chess2/blob/main/src/view/board-view.ts): `src/view/board-view.ts`
- [Hyperbolic display](https://github.com/geoff-jiang/chess2/blob/main/src/view/hyperbolic-display.ts): `src/view/hyperbolic-display.ts`
- [Camera fit](https://github.com/geoff-jiang/chess2/blob/main/src/view/camera-fit.ts): `src/view/camera-fit.ts`
- [Board theme](https://github.com/geoff-jiang/chess2/blob/main/src/view/board-theme.ts): `src/view/board-theme.ts`
- [Move explanation](https://github.com/geoff-jiang/chess2/blob/main/src/view/move-explanation.ts): `src/view/move-explanation.ts`
- [Labels](https://github.com/geoff-jiang/chess2/blob/main/src/shared/labels.ts): `src/shared/labels.ts`

### Match rules

- [Match engine](https://github.com/geoff-jiang/chess2/blob/main/src/shared/game.ts): `src/shared/game.ts`
- [Game protocol types](https://github.com/geoff-jiang/chess2/blob/main/src/shared/game-types.ts): `src/shared/game-types.ts`
- [Curved movement](https://github.com/geoff-jiang/chess2/blob/main/src/shared/curvature-moves.ts): `src/shared/curvature-moves.ts`
- [Standard chess adapter](https://github.com/geoff-jiang/chess2/blob/main/src/shared/standard-chess.ts): `src/shared/standard-chess.ts`
- **chess.js**

### Board geometry

- [Arena and anchors](https://github.com/geoff-jiang/chess2/blob/main/src/shared/geometry.ts): `src/shared/geometry.ts`

### Online rooms

- [Room server](https://github.com/geoff-jiang/chess2/blob/main/src/server/index.ts): `src/server/index.ts`

### Other components

- **Player**
- **Other player**

## Connections

- Player → Game controller: plays through (evidence: `README.md`)
- Game controller → Match engine: requests moves (evidence: `src/main.ts`)
- Game controller → Standard chess adapter: loads FEN (evidence: `src/main.ts`)
- Game controller → Arena and anchors: reads arena (evidence: `src/main.ts`)
- Game controller → Board renderer: updates view (evidence: `src/main.ts`)
- Game controller → Move explanation: explains routes (evidence: `src/main.ts`)
- Game controller → Room server: exchanges room actions (evidence: `README.md`)
- Board renderer → Match engine: reads match state (evidence: `src/view/board-view.ts`)
- Board renderer → Arena and anchors: renders tiles (evidence: `src/view/board-view.ts`)
- Board renderer → Hyperbolic display: projects tiles (evidence: `src/view/board-view.ts`)
- Board renderer → Camera fit: fits view (evidence: `src/view/board-view.ts`)
- Board renderer → Curved movement: shows pawn heading (evidence: `src/view/board-view.ts`)
- Board renderer → Board theme: uses theme (evidence: `src/view/board-view.ts`)
- Board renderer → Labels: labels pieces (evidence: `src/view/board-view.ts`)
- Move explanation → Arena and anchors: names tiles (evidence: `src/view/move-explanation.ts`)
- Move explanation → Labels: formats text (evidence: `src/view/move-explanation.ts`)
- Match engine → Arena and anchors: uses arena (evidence: `src/shared/game.ts`)
- Match engine → Curved movement: generates curved moves (evidence: `src/shared/game.ts`)
- Match engine → Standard chess adapter: adapts flat positions (evidence: `src/shared/game.ts`)
- Match engine → Game protocol types: uses state types (evidence: `src/shared/game.ts`)
- Curved movement → Arena and anchors: traverses edges (evidence: `src/shared/curvature-moves.ts`)
- Curved movement → Game protocol types: uses move types (evidence: `src/shared/curvature-moves.ts`)
- Standard chess adapter → Arena and anchors: maps chess squares (evidence: `src/shared/standard-chess.ts`)
- Standard chess adapter → Game protocol types: uses game types (evidence: `src/shared/standard-chess.ts`)
- Standard chess adapter → chess.js: adapts positions (evidence: `src/shared/standard-chess.ts`)
- Room server → Match engine: validates actions (evidence: `src/server/index.ts`)
- Room server → Other player: broadcasts snapshots (evidence: `README.md`)
