Chat Grid

Realtime spatial chat grid with:

• client/ TypeScript web app
• server/ Python websocket signaling server

Local Run

1. Start server

cd server
cp config.example.toml config.toml
uv run python main.py --config config.toml

2. Start client

cd client
npm install
npm run dev -- --host 0.0.0.0 --port 5173

3. Open http://localhost:5173

Production Deploy (quick path)

Use deploy/README.md.

Summary:

1. Copy repo to /home/bestmidi/chgrid.
2. Build client and publish client/dist/ to /home/bestmidi/public_html/chgrid/.
3. Configure server config.toml and run it via systemd.
4. Add Apache /ws websocket proxy from deploy/apache/chgrid-vhost-snippet.conf.

Key Paths

• Client version: client/public/version.js
• Client sounds: client/public/sounds/
• Server config template: server/config.example.toml
• Server runtime items: server/runtime/items.json

Documentation

• Controls/keymap: docs/controls.md
• Audio architecture and layers: docs/audio-architecture.md
• Item behavior by type: docs/item-types.md
• Runtime lifecycle flow: docs/runtime-flow.md
• Protocol behavior notes: docs/protocol-notes.md
• Item schema reference: docs/item-schema.md
• Local dev commands: docs/local.md