Codenames Board
A self-hosted board for playing Codenames around a table, with no accounts or installs: the spymasters see the key on their own phones, while everyone else sees the board on a TV, laptop or their phones. An unofficial fan project.
01 About
A board for playing Codenames in person without the box. The board goes on a TV, a laptop or the players' phones, and each spymaster sees the key on their own device. There are no accounts and nothing to install: everyone just opens a link.
Creating a game opens the spymaster view, which has links and QR codes for the other spymaster and the players; players can also type in a 5-letter game code. When a team guesses a word, a spymaster taps that card twice to reveal it, and every screen updates within a couple of seconds. The links stay the same between rounds, so the next game is one click.
It's a Laravel app with SQLite, and the board is plain JavaScript that checks for changes every second and a half, so no WebSocket server is needed. It ships as one Docker image with Nginx and PHP-FPM, runs its own migrations on start, and works behind a reverse proxy that handles HTTPS. Word lists are plain text files, one word per line.
02 Screenshots
03 What it does
- Separate spymaster and player views that stay in sync across any number of devices
- The rules are built in: a 9/8 split of agents, bystanders and the assassin, with wrong guesses passing the turn
- Share links and QR codes for the players and the second spymaster, or join with a 5-letter game code
- The spymaster link carries a random token, so players can't reach the key by guessing the URL
- English and Hungarian word lists; adding a language is a single text file
- Single Docker image (Nginx + PHP-FPM, SQLite) with automatic migrations; every push runs the tests and publishes the image to GHCR