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](/guide/architecture)** — the moving parts your game runs in: web app, API, game-server, viewer iframe. 2. **[Engine API](/guide/engine-api) & [Viewer API](/guide/viewer-api)** — the two contracts your code implements. 3. **[Tic Tac Toe tutorial](/guide/tictactoe)** — a complete minimal engine + viewer, end to end. 4. **[Adding a game](/guide/adding-a-game)** — how a finished game gets registered and hosted on the platform. Reference pages: [game options, preferences & settings](/guide/game-options) · [clocks & timing](/guide/timing) · [bot players](/guide/bots). Every page is also available as raw markdown — append `.md` to its URL, or send `Accept: text/markdown`. See [/llms.txt](/llms.txt) for the machine-readable listing.