Evaluation Guide

A hands-on walkthrough of RallyLab. Follow these steps to experience the full flow — from creating a rally to running a race and seeing results on the audience display. No account or hardware needed; everything runs in demo mode right in your browser.

Looking for the full reference? See the User Guide →
1

Enter Demo Mode

From the RallyLab home page, click "Sign In" (or "Try the Demo"). You'll see the login screen with two options: sign in with email, or try the demo.

  1. Click "Try Demo" at the bottom of the login screen.
  2. RallyLab creates a sample rally with three sections (Beaver Buggies, Kub Kars, Scout Trucks), several groups, and pre-populated rosters.
  3. You'll land on the Rally Home screen showing the demo rally dashboard.
Login screen with Try Demo button
The login screen — click "Try Demo" to get started without an account.

2

Explore Pre-Race Setup

The rally home screen is the organizer's dashboard. Take a moment to look around:

Rally Home dashboard
The Rally Home screen shows sections, groups, and participant counts at a glance.

Click on any section name to see its roster. You'll see participants listed by group, each with an assigned car number.

Section roster grouped by troop
A section's roster, organized by group.
Try it: Click "Add Participant" to add someone to a section. A car number is assigned automatically.

3

Open the Debug View

RallyLab's debug view shows the operator console, a fake track simulator, and the audience display side by side in a single window. This is the best way to see the whole system in action.

  1. From the Rally Home screen (step 2), click the "Race Day" button. This opens the Operator Console.
  2. Click "Load Demo Data". Leave the defaults in the dialog and click "Load".
  3. You'll land on the Operator Rally Home. Click the "Open" menu in the top nav bar and select "Debug View".
  4. The debug view opens with three panels: the Operator console on the left, the Fake Track at top-right, and the Audience Display at bottom-right.
Load Demo Data dialog
The Demo Data dialog pre-configures participants and check-in status.
Debug view showing operator, fake track, and audience panels side by side during staging
The debug view during staging — operator console (left), fake track with cars ready (top-right), and audience display (bottom-right).
Tip: The debug view works best on a wide monitor. If your screen is small, you can open the operator (operator.html) and audience (audience.html) in separate tabs instead.

4

Check In & Start a Section

This is the Operator's job — the only setup needed before the Track Operator takes over.

  1. In the Operator panel, click "Check In" on any section. Check the boxes to mark participants as arrived. (With demo data, some may already be checked in.)
  2. Once at least 2 participants are checked in, click "Start This Section".
  3. The lane selection dialog appears — leave all lanes checked and click "Start Racing".
Check-in screen
Check in participants as they arrive with their cars.
Lane selection dialog
Choose which lanes are active. The schedule is generated automatically.

The first heat is now staged. The operator console shows the lane assignments, and the audience display shows the same information to the crowd. From here, the Track Operator runs the race — the Operator doesn't need to click anything during normal heat progression.

Staging view
The staging view shows which cars go in which lanes.

5

Run Heats from the Fake Track

In a real race, the Track Operator is the person standing at the physical track — loading cars onto lanes, releasing the start gate, and resetting the finish switches between heats. The Operator at the computer doesn't need to touch anything; the track controller handles timing and heat advancement automatically.

In the debug view, you play both roles. The fake track panel simulates the physical track. Here's the cycle for each heat:

  1. Release Gate — Click the "Release Gate" button in the Fake Track panel. Cars animate down the track and finish times are generated automatically.
  2. See Results — Results appear on both the operator console and the audience display simultaneously. The standings update with cumulative averages.
  3. Reset Switches — Click the "Reset Switches" button. The next heat stages automatically — no operator click needed.
  4. Repeat — Keep clicking Release Gate and Reset Switches to run through all the heats.
Key insight: Notice that the Operator console advances through heats without any clicks. The entire race flow is driven by the Track Operator's two actions: release the gate, then reset the switches. This is how it works with real hardware too — the Pico W track controller detects gate release and finish times, so the Operator can focus on watching the race and handling exceptions.

Watch the audience display update in real time as you run heats:

Audience staging view
The audience sees the current heat staging with an "Up Next" preview.
Audience results view
Heat results with finish times and medals for the top finishers.
Operator results view
The operator console shows results and running standings — updated automatically.

6

Review Results & Inspect Events

After running all heats in a section, you'll see the final standings with rank, average time, best time, and heat count.

Final standings
Section complete — final standings with average and best times.

On the audience display, the operator can trigger a dramatic progressive reveal — standings appear from last place up to first, with medal animations for the top 3.

Audience medal reveal
The audience sees a dramatic reveal of final standings.

Event Inspector

RallyLab is event-sourced — everything that happens is stored as a domain event. From the Operator console, click the "Open" menu and select "Event Inspector" to see the raw event stream.

You'll see every event that was generated during your demo session: RallyCreated, ParticipantAdded, SectionStarted, RaceCompleted, and more. Click any event to see its full JSON payload, or use the "Replay to Here" tab to see the application state at any point in time.

Why this matters: Event sourcing means RallyLab can recover from crashes, sync between devices, and provide a complete audit trail of everything that happened during a race.

What's Next?