foiled

A collaborative editing system by Gumnut. TypeScript client and Go server communicating over WebSocket.

See DESIGN.md for architecture details.

Prerequisites

• Node.js (v23+)
• Go
• pnpm

Setup

pnpm install

Running

Start the Go server in one terminal:

go run ./server/bin/dummy/

Start the client in another:

./run.sh

All log output is redirected to /tmp/foiled.log (or pass a custom path: ./run.sh ./my.log). Tail it in a separate terminal:

tail -f /tmp/foiled.log

Testing

pnpm test         # TypeScript tests
go test ./...     # Go tests