logo
ConceptsGames

Games

Scheduling and managing matches in Klubb.

A game is a single match against an opponent. Admins create games; everyone on the team sees them on the Games tab.

Required fields

Every game has:

  • Home or awayisHome: true means you host, false means away
  • Opponent — free-text name of the other team
  • Date and match time — when the game starts
  • Status — one of scheduled, completed, cancelled

Optional fields

  • Warmup time — separate from the match start, e.g. for arrival
  • Arena — pick a saved arena instead of typing the address each time
  • Referees — link one or more saved referees
  • Notes — free-text, visible to everyone on the team

Lifecycle

A game moves through these states:

  1. scheduled — the admin creates the game
  2. completed — the match has been played
  3. cancelled — the game was called off

A game starts as scheduled. After it's played, an admin can mark it completed. If it's called off, mark it cancelled so the team isn't notified to show up.

Cancelling a game emits a game_cancelled notification to every team member. Use it deliberately.

Notifications around games

Creating, editing, or cancelling a game emits a notification to the whole team:

  • game_created — new game added
  • game_updated — fields changed (date, time, arena, etc.)
  • game_cancelled — status flipped to cancelled
  • game_reminder — sent automatically as the game approaches

See Notifications and alerts for how members manage these.