All projects
SIDE PROJECT / Live

Roundkeep.

A D&D 5e combat table that keeps working without internet.

TECHNICAL STACK4 technologies mapped
  • 01TypeScript
  • 02Socket.IO
  • 03Service Worker
  • 04PWA
SYSTEM MAP

How the project holds together

A compact view of the technologies behind the experience, grouped by the role they play in the product.

01

Runtime

  • Socket.IO
02

Delivery

  • Service Worker
  • PWA

Overview

Roundkeep runs a D&D 5e fight in the browser: initiative, HP, conditions, and a library of SRD creatures and spells. It runs on the Dungeon Master's machine, with no account and no cloud, and players follow the combat from their phones on the same network.

What it does

  • 01Combat table with turns, rounds, editable initiative, damage, healing, temporary HP and conditions.
  • 02Offline library with 331 SRD 2024 creatures and 319 spells.
  • 03Import from Improved Initiative or Roundkeep backups, with a review step before anything is saved.
  • 04Player view at /p/{id} for phones on the local network.
  • 05Portable JSON backups to move a campaign to another device.
  • 06Keyboard shortcuts for next turn, library search, dice and undo.

How it’s built

  • 01The player view updates live over Socket.IO on the LAN, with a BroadcastChannel fallback inside the same browser.
  • 02Catalogs live in IndexedDB and the encounter saves on every change. After the first load, a service worker makes the production build work offline, with cache versions generated at build time.
  • 03Web Locks allow only one Dungeon Master tab to edit the campaign at a time, so two tabs never overwrite each other. Player windows stay open in parallel.
  • 04The table binds to the LAN, but the bootstrap endpoint that serves private campaign data only answers on loopback. It is not a public cloud room.
  • 05The SRD catalog is converted from Open5e v2 by a reproducible Python script, with credits and licenses shipped inside the app.
  • 06Tests cover encounter rules, catalog data and import.

Creature records come from SRD 5.2 (2024) via Open5e under CC BY 4.0. Spells come from the basic catalog distributed by Improved Initiative.