Poker — Multiplayer Texas Hold'em

A multiplayer Texas Hold'em poker app with two frontends (web, TUI) connecting to a shared WebSocket server.

Architecture

Crate	Description
poker-core	Core game logic, protocol types, and transport abstraction
poker-server	Multi-room Axum server with WebSocket support
poker-client	Client-side networking, game state, session persistence, and reconnection logic
poker-ui	Platform-agnostic Dioxus UI components and application lifecycle
poker-web	Thin Dioxus web + PWA shell (WASM)
poker-tui	Ratatui terminal frontend

Quick Start

1. Build the web frontend

cd crates/poker-web
npm install
npx tailwindcss -i assets/input.css -o assets/tailwind.css
dx build --release

This produces a dist/ directory with the static web assets.

2. Run the server

# From the workspace root:
cargo build -p poker-server --release

# Serve the web frontend from the dist/ directory:
STATIC_DIR=crates/poker-web/dist ./target/release/poker-server

The server listens on 0.0.0.0:8080 by default. Configure with:

• PORT — listen port (default: 8080)
• STATIC_DIR — path to the Dioxus web build output (default: ./dist)

Open http://localhost:8080 in a browser to play.

3. TUI client

cargo build -p poker-tui --release

# Create a room and join:
./target/release/poker --server ws://127.0.0.1:8080 --room myroom --name Alice --create

# Join an existing room:
./target/release/poker --server ws://127.0.0.1:8080 --room myroom --name Bob

Development

# Check everything compiles:
cargo check

# Run tests:
cargo test

# Run the server in dev mode:
cargo run -p poker-server

# Build the web frontend in dev mode:
cd crates/poker-web && dx serve

Gameplay

1. One player creates a room (picks a room ID)
2. Other players join using the same room ID
3. Any player can start the game once 2+ players have joined
4. Standard Texas Hold'em rules with blinds, betting rounds, and showdown