Public events¶
A public event is a single track with a shared reference run and a public leaderboard on the open web. It's the right tool when you want every rider's time on the same track, in one place, visible to riders and spectators without an account.
For organizer-facing usage and setup, see For Event Organizers. This page is the concept definition.
What an event has¶
- a title
- a start and end time (the leaderboard accepts uploads only inside this window)
- a reference run that defines the track for the whole event
- a WhatsApp group invite link for riders during the event
- a public web page at a unique URL with a QR code
- a published flag (when off, the public page is hidden)
Where an event lives¶
An event lives outside any team. It's its own object, with its own runs and its own leaderboard. A rider can participate in a public event without being on any team.
Riders on an event¶
A rider scans the QR or follows the link, lands on the event's public page, and uploads their run from the app. Each upload:
- is processed by Racecraft
- is aligned against the event's reference run
- has its splits predicted at the same checkpoints as the reference
- lands on the public leaderboard once the splits are confirmed
The leaderboard ranks the rider in the video — the athlete name tagged on the run — not the uploader's account.
Public events vs team sessions¶
| Team session | Public event | |
|---|---|---|
| audience | private to the team | open on the web |
| who can upload | team members only | anyone with the link, during the window |
| who can view | team members only | anyone, no account needed |
| reference run | shared by the team | shared by everyone on the event |
| identity shown | rider, scoped to the team | rider, public |
The analysis machinery — splits, alignment, time delta, leaderboard — is the same in both. What changes is who can see and contribute.
Lifecycle¶
- created — the event exists but is not yet visible
- published — the public page is live, the leaderboard accepts uploads during the window
- window ended — the leaderboard freezes, no new uploads land
- unpublished — the page is hidden, but the underlying data persists
Today, events are admin-set-up — see Requesting an event for how to get one configured.
Multiple categories¶
A single leaderboard is a single ranking. If an organizer wants separate rankings for different categories (Cat 1 vs Cat 2, men's vs women's), each category is a separate public event with its own reference, its own QR code, and its own leaderboard.