Skip to main content

Quick-Start Tour

A 5-minute walkthrough of the v0.1.0 surfaces. Assumes you've already brought up the local stack (make up-d && make migrate && make seed) and opened http://localhost:6166.

1. Log in​

Use the seeded demo credentials:

  • Email: demo@race.local
  • Password: demo
  • Account slug: demo-racing

Screenshot placeholder — login screen

2. The shell​

You land on the Dashboard. The shell has five horizontal strips:

StripPurpose
Ribbon bar (top)Account name + section tabs (Championship · Event · Analysis · Admin) + Documentation / Search / Notifications / Sign-out
Sub-toolbarOffice-style action icons for the active tab
Context stripCascading dropdowns: Championship → Event → Session → Car
Status strip"Context set" / "No context" indicator + environment badge
SidebarSections + features. Collapses to a rail at tablet width, drawer at phone width.

The active section drives the sub-toolbar and sidebar. Pick Championship → 2026 IMSA in the dropdowns to see the seeded event appear.

Screenshot placeholder — shell with annotated regions

3. Pick an event​

In the Championship tab, click Events. You'll see the seeded Sebring 12 Hours event. Click it — the Event tab in the ribbon now lights up.

You can also select the event directly from the context strip; the dashboard updates to show only that event's data.

Screenshot placeholder — events list

4. Open a run sheet​

Switch to the Event tab. The sub-toolbar shows the eight event surfaces:

  • Run Sheets
  • Run Plan
  • Strategy
  • Session Clock
  • Weather
  • Tyres
  • Setups
  • Jobs & Issues

Click Run Sheets. Pick a session and car from the context strip (the seed data gives you a Saturday FP1 session and one car).

The Run Sheet has seven tabs:

TabWhat it does
MainPer-lap grid of lap times, sectors, channels
SetupThe car's setup parameters for this run — toggle CID or hand-coded form
TyresPer-tyre temperatures and pressures
AmbientWeather measurements taken near the run
NotesFree-text engineer notes
FilesAttached telemetry / video files
OverviewRead-only summary card

Screenshot placeholder — run sheet with tabs visible

5. Try a custom view​

In the Admin tab, open Custom Views. You'll see two seeded views:

  • Pit Window Calculator — a CID-rendered calculator
  • All Laps — a multi-session table

Click the path under either entry (/custom/pit-window-calculator, /custom/all-laps) — the runtime renders the view immediately. These views are data, not code: the spec is editable in /admin/custom-views and the rendering updates live.

6. Run a plugin​

Switch to the Analysis tab → Plugin Runner. The seeded plugin race-demo:rolling-avg-rpm@1.0.0 is preselected. Hit Invoke in the Math card — the rolling-average values appear in the result panel. Switch to the KPI card and hit Run — the lap-mean of the 5-second rolling RPM average appears.

This same plugin can run on the server (today) or in the browser via QuickJS (scaffolded; ships in a follow-up).

Screenshot placeholder — plugin runner with results