Bertold Héjja

Budapest, Hungary

Electrical Engineer · Senior Software Engineer · Project Manager

ERP, embedded systems & cloud — from the circuit board to the product roadmap.

← All projects

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

Spymaster view: the whole key in red, blue, neutral and black, with revealed cards ticked
Spymaster view, with the whole key
Player view: unrevealed cards are neutral, revealed ones show their team colour
Player view, where a card shows its colour once revealed

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

04 Built with

  • Laravel
  • PHP
  • JavaScript
  • SQLite
  • Docker
  • Nginx
  • GitHub Actions