Boardgamers

Mono-repo for the whole architecture of boardgamers.space.

Requirements

pnpm

We use pnpm as our package manager!

Node.js

A recent version of node, 14+ ideally, is required

Running

Frontend

There is a webapp and an admin.

pnpm --filter web dev
pnpm --filter admin dev

You can directly run the frontend against the website! No need to run the backend. To do so, just create .env in the apps/web folder with VITE_backend=https://boardgamers.space.

Backend

You can follow the instructions in api-node and game-server, or you can just run the following command:

# start mongodb backend
docker compose up -d

pnpm --filter api dev
# launch in another terminal
pnpm --filter game-server dev

Everything at once

From the repo root, this runs the api, game-server and webapp in parallel:

docker compose up -d # mongodb
pnpm dev

Add pnpm dev:admin for the admin panel.

Multiple isolated instances

To run several copies of the stack side-by-side (e.g. one per agent or per PR), give each its own worktree and loopback IP.

See the "Running instances" section of AGENTS.md for details.