Home

VGDE

How to play

• Core Rules — what applies no matter what mode or settings you're playing with (anonymity, voting basics, minimum players)
• Game modes:
  • Classic Count — fixed number of questions, repeat votes allowed
  • Deck Mode — one vote-card per other player, no repeats
  • First to N Cards — play in batches until someone wins outright
• Admin options (host-configurable, independent of mode):
  • Tie-Breaking and Reveal — how a tied question gets resolved, and how results become visible
  • Categories and Delegation — excluding question categories, and handing the mode/category decision to a group vote instead of the host picking alone
• Custom Cards and Your Account — writing your own question cards, sharing a deck without a designated host, and deleting your account
• Finding a Game Again — getting back into a game you're already part of without needing its join code

Deploying it yourself

Complete, self-contained docker-compose.yml examples for each supported auth setup — copy straight into an empty directory and run, no local clone or build step needed (image: pulls a prebuilt image straight from GHCR):

• Deploy: Password + OIDC — both login paths active at once
• Deploy: OIDC only — single sign-on is the only way in
• Deploy: Password only — no external identity provider, the simplest option
• Updating a Deployment — pulling in new changes for an instance you already have running

For everything else — the stack, security notes, running from a local clone instead — see the main README.