Racing 2 min read

How do the run viewer and leaderboards connect in Drivurs?

Why the run viewer, uploaded sessions, and leaderboards should read as one truth layer instead of separate racing surfaces.

Drivurs Team Drivurs Team
Published
Last updated

TL;DR

The run viewer and leaderboards should not feel like separate systems.

The run viewer explains the recorded attempt. The leaderboard decides whether that attempt belongs in ranking context.

Both should resolve back to the same session and vehicle truth.

What the run viewer is for

The run viewer helps the user interpret the run itself.

That includes things like:

  • metric tiles,
  • graph views,
  • quality state,
  • and the vehicle attached to the run.

Its job is explanation, not just celebration.

What the leaderboard is for

The leaderboard is the ranking layer.

Its job is to place a run inside a broader comparison context while still preserving trust.

That only works if the leaderboard entry can be traced back to:

  • the run,
  • the session,
  • and the vehicle that produced it.

Why continuity matters

If the viewer and leaderboard feel disconnected, users start asking the wrong questions:

  • “Is this the same run?”
  • “Why does the leaderboard trust this?”
  • “What vehicle actually produced this entry?”

Continuity reduces doubt.

What should stay visible across both surfaces

At minimum, both surfaces should keep consistent access to:

  • vehicle identity,
  • run validity state,
  • the relevant metric,
  • and the path back to the recorded attempt.

That is what makes the system feel like one product instead of separate racing widgets.

Review before ranking

Open the run viewer before treating a leaderboard position as proof. Confirm the attached vehicle, metric definition, completion and validity state, and whether warnings need context. A rank answers where an accepted result sits; it does not explain the conditions or why another attempt differed.

For build comparisons, keep the unranked context too: tire and fuel setup, modification state, starting temperatures, and the session notes. If the vehicle configuration changes, create a clear record of that change rather than letting the leaderboard imply that every result came from the same setup. This keeps competition readable without turning the ranking surface into a substitute for the underlying run.

Next steps

Record the next session

Put “How do the run viewer and leaderboards connect in Drivurs?” into practice.

Run a live RaceBox session in Drivurs, review the result, and compare repeatable attempts instead of a single headline number.

See Racing in Drivurs

Use it in Drivurs

Explore Racing

Run sessions, validate attempts, inspect graphs, and publish to leaderboards.

Want to keep learning?

Browse the Drivurs Academy hubs for checklists, comparisons, and reference.