Run Sheets
The Run Sheet is the engineer's central artefact during a session — one per session × car. It collects every lap, every setup adjustment, every tyre measurement, weather snapshot, note, and file related to that car running in that session.
Find it under Event → Run Sheets in the ribbon. The route is
/events/:eventId/run-sheets.
Tabs
The Run Sheet is a tabbed editor. The tab list as of Phase 3:
| Tab | What's in it |
|---|---|
| Main | Per-lap grid: lap number, lap time, sectors, in/out, marker chip, and any custom Lap parameters. Columns are driven by the Lap custom-column profile (see Custom Columns Editor). |
| Setup | The car's setup parameters. Toggleable between CID (rendered from a Setup Definition) and Form (hand-coded fallback) via a segmented control. |
| Setup Change | A diff-style log of how the setup was changed during the session — drives the Setup Comparison surface. |
| Tyres | Per-tyre temps and pressures captured for this run. |
| Wear Sheet | Surfaces the live tyre-wear measurements (see Tyres). |
| Ambient | Weather measurements captured near the run timestamp. |
| Engineer Notes | Free-text engineer notes (Markdown-ish). The first-class home for run-by-run commentary. |
| Files (V2) | Attached telemetry / video / photos via the Phase-3 attachments flow (/attachments/upload). The legacy V1 tab is hidden by default. |
| Overview | Read-only summary card — best lap, average pace, in/out laps, total laps. |
The exact tab list adapts to the entity types present (e.g. the
Setup tab disappears if the active session has no associated setup
definition). Behind the scenes each tab is a self-contained
widget under
apps/client/lib/src/features/run_sheet/tabs/.
Custom Lap parameters
Any parameter defined on the Lap Definition shows up automatically
as a column on the Main tab. Math parameters (e.g.
PaceToLeader = LapTimeMs - Session.BestLapTimeMs) are computed
on read.
The Main tab uses the default Lap custom-column profile if the account has authored one — otherwise a sensible hand-coded default. See Custom Columns Editor for how to author one.
Setup Change tab
The Setup Change tab shows the run's setup as a structured diff against the previous run's setup. It uses Change Formatters (see Admin → Change Formatters) to render parameter groups consistently — same headings as the Setup Comparison screen.
What you can do today
- Open and edit any seeded run sheet
- Add / edit / delete laps via the Main tab (CRUD against
/laps) - Switch the Setup tab between CID and Form
- Track per-run setup changes via the Setup Change tab
- Attach files via the V2 Files tab
- View aggregated stats on the Overview tab
What's coming
- Multi-user CRDT editing — today edits are last-writer-wins through the REST API. Automerge over WebSocket will land in a later phase.
- Auto-population from the edge ingester — feed an Al Kamel CSV or live feed via the Rust binary and the run sheet populates lap-by-lap. The replay adapter exists; live adapters are roadmap.
- Lap KPIs surfaced inline — KPI plugins run today (see Lap KPIs) but their results aren't yet rendered as columns on the Main tab.