words-tui
v0.1.0
Published
Multiplayer word game in your terminal — create a lobby, share the invite code, play with up to 5 people.
Maintainers
Readme
Words TUI
A two-player asynchronous word-tile game built with Effect, OpenTUI, Alchemy v2, and Cloudflare Durable Objects.
Development
bun install
bun run test
bun run check
bun run devbun run dev uses local Alchemy state and workerd, so it does not require Cloudflare credentials. Run the terminal client against it:
WORDS_SERVER_URL=http://localhost:8787 bun run cliDeploy the Worker and its SQLite-backed Durable Object:
bun run deployProduction deployment uses Alchemy's Cloudflare-hosted state store and requires alchemy login first.
Build a standalone executable for coworkers who do not have Bun installed:
bun run build:binary
./dist/words-tuiThe client defaults to the deployed Worker at https://wordstui-wordsworker-dev-kit-dz7zuwcr4dg7c7lg.kit-langton.workers.dev. Set WORDS_SERVER_URL only when targeting a local or alternate server.
Current Rules
The playable slice supports two to five players, invite-code lobbies, persistent games, English dictionary validation, premium squares, live score previews, direct letter typing, passing, reconnecting, and live turn updates. The host presses Ctrl-S once at least two players have joined. Blank tiles and exchanges are intentionally deferred.
Game controls:
- Type a letter from your rack to stage it at the highlighted valid square.
- Use the arrow keys to move between valid placement squares.
- Press
Backspaceto undo the last staged tile. - Press
Enterto submit the move. - Press
Ctrl-Pto pass andCtrl-Qto quit.
