Architecture overview

Architecture overview

Key files

File	What it does
server.js	Express + Socket.io entry point
gameNamespace.js	All game logic — move validation, game over, Veil/Ruin/Sanctuary rules
roomStore.js	In-memory room state for remote play
atprotoPoster.js	Posts match results to the-rift Bluesky account on game over
public/index.html	The entire client — board, PIXIE panel, Speak Move button
services/	Player profile management
data/	Default profile config

Request flow

Browser → Socket.io → gameNamespace.js → roomStore.js
Game over → atprotoPoster.js → Bluesky

Gemini agent (PIXIE)

PIXIE runs via the /api/agent endpoint. System prompt lives in server.js.