MicuPoker Documentation

Play-money Texas Hold'em over Phoenix real-time channels

MicuPoker is an educational multiplayer poker demo. Chips are virtual demo chips only, have no real-world value, and cannot be bought, sold, deposited, withdrawn, paid out, cashed out, or converted to money or crypto.

What v1 Does

Guests receive a server-side demo account, create or join rooms, sit at a table, chat, receive private cards, act in turn, and finish hands in real time.

Table Creation

Rooms validate name, max seats from 2 to 9, starting virtual chips, blinds, and spectator mode. Password-protected rooms are intentionally disabled in v1 until full access control is implemented.

Poker Actions

The server validates fold, check, call, bet, raise, and heads-up all-in. Turn order, deck, cards, stack changes, pot state, and winners are server-authoritative.

WebSocket Events

Endpoint: /socket. Topic: table:<room_id>. Events: state, action, and chat. Phoenix LiveView also uses /live.

API Routes

GET /health, GET /api/rooms, GET /api/rooms/:id, GET /api/stats. Browser routes include /, /lobby, /rooms/:id, and /docs.

Limitations

v1 intentionally keeps all-in support to heads-up play and documents full multi-player side pots as TODO. Persistent private hole-card history is not exposed by public APIs.