How geoff-jiang/chess2 works
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: board-view.ts Board renderer · main.ts Game controller · game.ts Match engine · geometry.ts Arena and anchors
Components 16
Browser game
- Game controller
src/main.ts - Board renderer
src/view/board-view.ts - Hyperbolic display
src/view/hyperbolic-display.ts - Camera fit
src/view/camera-fit.ts - Board theme
src/view/board-theme.ts - Move explanation
src/view/move-explanation.ts - Labels
src/shared/labels.ts
Match rules
- Match engine
src/shared/game.ts - Game protocol types
src/shared/game-types.ts - Curved movement
src/shared/curvature-moves.ts - Standard chess adapter
src/shared/standard-chess.ts - chess.js
Board geometry
- Arena and anchors
src/shared/geometry.ts
Online rooms
- Room server
src/server/index.ts
Other components
- Player
- Other player
Connections 27
- Player → Game controller: plays through
README.md - Game controller → Match engine: requests moves
src/main.ts - Game controller → Standard chess adapter: loads FEN
src/main.ts - Game controller → Arena and anchors: reads arena
src/main.ts - Game controller → Board renderer: updates view
src/main.ts - Game controller → Move explanation: explains routes
src/main.ts - Game controller → Room server: exchanges room actions
README.md - Board renderer → Match engine: reads match state
src/view/board-view.ts - Board renderer → Arena and anchors: renders tiles
src/view/board-view.ts - Board renderer → Hyperbolic display: projects tiles
src/view/board-view.ts - Board renderer → Camera fit: fits view
src/view/board-view.ts - Board renderer → Curved movement: shows pawn heading
src/view/board-view.ts - Board renderer → Board theme: uses theme
src/view/board-view.ts - Board renderer → Labels: labels pieces
src/view/board-view.ts - Move explanation → Arena and anchors: names tiles
src/view/move-explanation.ts - Move explanation → Labels: formats text
src/view/move-explanation.ts - Match engine → Arena and anchors: uses arena
src/shared/game.ts - Match engine → Curved movement: generates curved moves
src/shared/game.ts - Match engine → Standard chess adapter: adapts flat positions
src/shared/game.ts - Match engine → Game protocol types: uses state types
src/shared/game.ts - Curved movement → Arena and anchors: traverses edges
src/shared/curvature-moves.ts - Curved movement → Game protocol types: uses move types
src/shared/curvature-moves.ts - Standard chess adapter → Arena and anchors: maps chess squares
src/shared/standard-chess.ts - Standard chess adapter → Game protocol types: uses game types
src/shared/standard-chess.ts - Standard chess adapter → chess.js: adapts positions
src/shared/standard-chess.ts - Room server → Match engine: validates actions
src/server/index.ts - Room server → Other player: broadcasts snapshots
README.md