41 lines
927 B
Markdown
41 lines
927 B
Markdown
|
# Chat Grid
|
||
|
|
|
||
|
|
Realtime spatial chat grid with:
|
||
|
|
- `client/` TypeScript web app
|
||
|
|
- `server/` Python websocket signaling server
|
||
|
|
|
||
|
|
## Local Run
|
||
|
|
|
||
|
|
1) Start server
|
||
|
|
```bash
|
||
|
|
cd server
|
||
|
|
cp config.example.toml config.toml
|
||
|
|
uv run python main.py --config config.toml
|
||
|
|
```
|
||
|
|
|
||
|
|
2) Start client
|
||
|
|
```bash
|
||
|
|
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`
|