BGS Docs
BGS logo

Docs for the boardgamers ecosystem

How the boardgamers.space platform works, and how to add your own board game to it.

Get started →

Add your game

Write a game engine (any TypeScript/JavaScript — one small API surface) and a viewer, and the platform runs them: matchmaking, clocks, Elo, replays, mobile & desktop — no restart needed to publish or update a game.

Read the guide →

Play

Just here to play? The platform hosts asynchronous and live games of Gaia Project, Power Grid, Container, 6nimmt! and more.

Go to boardgamers.space →

Open source

The platform and every game on it are open source — read real engines and viewers for inspiration, and contribute your own.

Platform source → · Game repos →

Adding a game, in four steps

  1. Architecture — the moving parts your game runs in: web app, API, game-server, viewer iframe.
  2. Engine API & Viewer API — the two contracts your code implements.
  3. Tic Tac Toe tutorial — a complete minimal engine + viewer, end to end.
  4. Adding a game — how a finished game gets registered and hosted on the platform.

Reference pages: game options, preferences & settings · clocks & timing · bot players.

Every page is also available as raw markdown — append .md to its URL, or send Accept: text/markdown. See /llms.txt for the machine-readable listing.