Overview Link to section: Overview
I built Poker With Your Friends as a realtime Texas Hold’em (poker with two private cards per player and five shared cards) table for two to six people. Choose a name and avatar, create a room, and invite friends with a link, QR code, or four-letter room code. No account or download is required.
Players can chat and react at the table, and up to 24 watchers (spectators) can follow along without seeing live hole cards (each player’s private cards). Discord Activity support lets the same game run inside Discord.
Table rules and play Link to section: Table rules and play
Dealing and betting Link to section: Dealing and betting
The server deals hands and resolves betting, including blinds (required bets before play) and side pots (separate pots for players who bet different amounts when all-in). The browser sends player actions to the server and displays the shared result.
Hosts can choose Casual, Deep stack, or Quick game presets, or customize starting chips, blinds, and the turn timer. Ready checks and automatic dealing keep hands moving. The Players & chips panel shows session profit and lets players take breaks or top up; hosts can add bots or pass hosting. Missed turns start an automatic break.
Rooms can optionally appear in the lobby’s Open tables list when a seat is free. Hosts can remove players or lock a room to prevent new players and watchers from joining.
Tournaments Link to section: Tournaments
Tournament mode starts everyone with equal stacks and locks the roster on the first deal. Blinds rise by 50% at a chosen interval of completed hands, and there are no refills. Eliminated players can keep watching, and Play again starts a rematch.
Saving and reconnecting Link to section: Saving and reconnecting
Players can reconnect from the same browser to reclaim their seats. Heartbeats (regular connection checks) detect stalled connections, and rooms persist as JSON snapshots (saved room data in a structured text format). Interrupted hands are refunded after a server restart; empty rooms expire after 30 days.
Practice bots Link to section: Practice bots
Five bot personalities (computer-controlled players) fill out a table when friends are not around:
- Bold.
- Steady.
- Careful.
- Tricky.
- Loose.
Solo hosts can start practice while waiting for friends. Those waiting bots leave before the next social hand when friends arrive.
Replays and poker nights Link to section: Replays and poker nights
The latest 20 hands stay in the room’s history, with step-by-step replay, adjustable playback speed, and jumps between streets (betting rounds). Notable showdowns prompt the winner to share an optional public hand replay, with folded cards kept private.
Session recaps show net chips and the biggest pot, with a public share link and a downloadable PNG image. Optional settle-up notes stay in the browser and are never published; there is no payment integration. Recaps also offer a calendar download for the same time next week and a way to host the next game.
Room invites have their own link previews showing the host, occupancy, and casual or tournament mode, without exposing cards or chips.
Discord Activity Link to section: Discord Activity
The game supports Discord’s embedded-app SDK (software development kit for apps running inside Discord). The browser game also works without Discord configuration.
Architecture and testing Link to section: Architecture and testing
Client and server Link to section: Client and server
I built the client with React and TypeScript, using Vite for builds and Tailwind CSS for styling. A single Node server runs through tsx and uses WebSockets (persistent two-way connections) through ws. It is authoritative: the server has the final say on game rules and state. Per-IP rate limits constrain WebSocket traffic.
Keyboard shortcuts cover folding, checking or calling, and raising. The interface has 44 px touch targets, screen-reader labels for cards and chip totals, and respects reduced-motion preferences.
Deployment and checks Link to section: Deployment and checks
The Docker image (a packaged application and its runtime) runs on Railway behind the Cloudflare-managed custom domain. Sharp renders PNG share images and link previews. A public /metrics dashboard reports anonymous aggregate funnel totals and deduplicated human activity.
Unit tests cover hand evaluation, betting, replay, and sharing. WebSocket and HTTP integration suites (tests of connected components) and a production packaging test check the server and release package.
Current state Link to section: Current state
The game is live at pokerwithyourfriends.com, free to play, and requires no accounts. It uses play money only: no real money, prizes, or cash-out. The source repository is private.
Explore the site Link to section: Explore the site
- How to play poker online with friends — create and share a table.
- Texas Hold’em rules guide.
- Poker hand rankings.
- Practice poker against bots.
- Play poker on Discord.
- Host a virtual poker night.
- Heads-up poker online — play with two people.
FAQ
Is Poker With Your Friends free?
Yes. It is free to play and uses play money only: no real money, prizes, or cash-out.
How many players can join a table?
Two to six players, plus up to 24 watchers who can follow along without seeing live hole cards.
Do players need an account or a download?
No. Choose a name and avatar, create a room, and invite friends with a link, QR code, or four-letter room code.
Can I play poker against bots?
Yes. Five bot personalities can fill out a table, and solo hosts can start practice while waiting for friends.
Does it work inside Discord?
Yes. The game supports Discord Activities, and the browser game also works without Discord.
Build photos






