Cursor rule

1---
2description: SimHub dashboard, overlay, and plugin tab UI conventions
3globs: plugin/**/*.html, plugin/**/*.xaml, plugin/**/*.simhubdash
4alwaysApply: false
5---
6 
7# SimHub Dashboard & Overlay Conventions
8 
9> **Note:** Glob patterns above are provisional. Update them once the dashboard file format and directory structure are finalized.
10 
11## Replay Mode Overlay (FR-003)
12 
13- Built in SimHub Dash Studio as a transparent overlay
14- Visible only during iRacing replay mode; hidden during live racing
15- Shows: incident list (time, severity, source), jump-to-incident controls, OBS record buttons, connection status
16- Positioned unobtrusively -- must not block critical replay HUD elements
17- Design for readability at a glance (large fonts, high contrast)
18 
19## Live Racing Toast (FR-003)
20 
21- Minimal, non-interactive notification during live racing
22- Shows incident time and severity (e.g., "4x captured at 12:34")
23- Auto-dismisses after a few seconds -- the driver is driving
24- No interactive buttons during live racing
25 
26## Plugin Settings Tab (FR-008)
27 
28- WPF `UserControl` rendered inside SimHub's desktop settings shell
29- Sections: OBS connection, hotkeys, detection toggle, replay offset
30- Not Dash Studio -- settings use SimHub's built-in WPF hosting
31 
32## Incident Log (FR-009)
33 
34- WPF ListView or DataGrid in the settings tab area
35- Shows all session incidents with timestamps, severity, source
36- "Jump to Replay" action per incident row
37 
38## Property Binding
39 
40- Expose all data needed by dashboards/overlays as SimHub plugin properties
41- Name properties with the `SimSteward.` prefix for namespace clarity
42- Ensure property updates are throttled appropriately to avoid UI flicker
43- Key properties: incident list, OBS connection status, replay mode state, recording state
44 
45## Recording Progress (FR-015, Part 2)
46 
47- Overlay shows which camera angle is currently recording (e.g., "Recording angle 1 of 2...")
48- Extends the replay mode overlay from FR-003
49