Screen inventory
A reference list of every distinct UI surface in Pit. Use this to size visual work, plan Storybook stories, or trace where a feature lives. Surfaces are grouped by shell location — the mode or window type that hosts them.
Storybook is the design-iteration surface for these screens. Every UI feature gets a Storybook story before functional wiring per the Storybook-first rule.
Pre-shell
Screens shown before the three-mode shell takes over.
| Surface | Type | Version | Notes |
|---|---|---|---|
| Splash | Full screen | v0.9.0 | Recent shows + New Show + Open Show + “what’s new” panel |
| New Show wizard | Modal | v0.9.0 | 6 steps — see New Show wizard |
| Open Show file picker | OS dialog | v0.3.0 | Native file dialog, shipped |
| Save / Save As | OS dialog | v0.3.0 | Native file dialog, shipped |
| Update available | Modal | v0.15.0 | Tauri updater UI |
| Onboarding tour | Modal sequence | v0.15.0 | First-launch only, dismissable |
Setup mode
Rig + show configuration. Screens that live inside Setup’s main canvas.
| Surface | Version | Notes |
|---|---|---|
| Show settings | v0.9.0 | Metadata, Production / Source / Distribution, autosave |
| Audio I/O | v0.2.0 | Shipped — extended in v0.6.0 with WASAPI/ASIO |
| MIDI devices | v0.6.0 | Per-device labeling, hardware MIDI binding |
| Rig components | v0.6.0 | Keyboards, footswitches, expression pedals, button/switch components |
| Buses | v0.8.0 | Main mix, IEM, click bus, conductor bus, custom |
| Plugin scan | v0.6.0 | Re-scan trigger, cache state, requirements report |
Program mode
The show-authoring canvas. The selected outline item determines what’s shown.
| Surface | Selection | Version | Notes |
|---|---|---|---|
| Outline | Always visible (left) | v0.3.0 | Show → songs → patches → library |
| Patch graph editor | Patch selected | v0.5.0 | Multi-plugin chain hosting (shipped) |
| Plugin GUI dock | Patch selected, plugin(s) loaded | v0.6.0 | Bottom panel of patch editor; tab strip for each loaded plugin’s CLAP GUI; per-plugin pop-out to floating window |
| Song settings | Song selected | v0.9.0 | Sub-tabs: Settings / Click / Backing / Patches |
| Library entry editor | Library entry selected | v0.10.0 | Patch-as-reference data model |
| Click track editor | Song’s Click tab | v0.12.0 | Vamps, codas, cue points, rits, ralls |
| Backing track editor | Song’s Backing tab | v0.13.0 | Track list, transport, cue points |
| Layout editor | Layout chosen | v0.11.0 | Grid editor, widget palette |
| Rig component widget editor | Component selected | v0.10.0 | Compound widget appearance |
| Inspector | Right side, contextual | v0.3.0 | Properties of current selection (shipped, grows per version) |
| Pit Mixer | Dedicated surface | v0.10.0 | Multi-channel audio input mixer |
| Balance tool | Dedicated surface | v0.12.0 | LUFS measurement, A/B compare, trim suggestions |
| Pre-show validation dashboard | Dedicated surface | v0.8.0 | Becomes a Live entry gate in v0.11.0 |
Perform mode
Read-mostly runtime view. Composed entirely of user-placed widgets.
| Surface | Version | Notes |
|---|---|---|
| Perform canvas | v0.11.0 | Grid of widgets per the chosen layout |
| Live fullscreen | v0.11.0 | Hides menu bar + chrome |
| Layout template picker | v0.11.0 | Blank / Minimal / Cabaret / MD Console |
Floating windows
Separate OS windows; can move to second monitors.
| Window | Version | Notes |
|---|---|---|
| Settings | v0.9.0 | Per-app preferences, not show settings |
| Plugin GUI (popped out) | v0.6.0 | Secondary placement — per-plugin pop-out from the patch editor’s plugin GUI dock. CLAP GUI extension embed. Default placement is docked in the patch editor, see Program mode table above. |
| Conductor cam pop-out | v0.11.0 | For second-monitor display |
| Parameter favorites pop-out | v0.11.0 | Touch-target parameter widgets |
Modals
Transient dialogs.
| Modal | Version | Notes |
|---|---|---|
| New Show wizard | v0.9.0 | 6-step show creator |
| Close blocker (unsaved changes) | v0.9.0 | “Save / Discard / Cancel” |
| Merge graph edits | v0.10.0 | Per-instance update/keep/three-way-merge |
| Orphan reattach | v0.10.0 | Re-link / save-new / keep-snapshot for missing library entries |
| Plugin requirements report | v0.7.0 | Missing-plugin list with “find this plugin” links |
| Pre-show validation gate | v0.11.0 | Blocks Live entry; overrideable |
| Crash reporter consent | v0.15.0 | First-launch opt-in |
| Telemetry consent | v0.15.0 | First-launch opt-in |
| Theme save / share | v0.15.0 | Theme editor output |
| Extension install permission | v0.15.0 | Capability consent UI |
Diagnostic / dev surfaces
Visible only when explicitly opened. Not part of the normal performer workflow.
| Surface | Version | Notes |
|---|---|---|
| Latency measurement tool | v0.6.0 | Loopback round-trip measurement |
| Latency budget breakdown | v0.15.0 | Per-API timings; release-engineering deliverable |
| Engine monitor (embedded) | v0.11.0 | Widget in Perform mode |
| Plugin scan report | v0.6.0 | What was found, what cached, what’s missing |
Native menus
The OS file menu structure. Mode switches are not in the menu bar.
| Menu | Items | Version |
|---|---|---|
| File | New, Open, Open Recent, Save, Save As, Import, Export, Quit | v0.9.0 |
| Edit | Undo, Redo, Cut, Copy, Paste, Select All, Preferences | v0.9.0 |
| View | Zoom In/Out, Toggle Inspector, Toggle Outline | v0.9.0 |
| Window | Settings, Plugin GUI list, Conductor cam, Bring all to front | v0.9.0 |
| Help | Documentation, Report a bug, About Stardust Pit | v0.9.0 |
Inline elements
Always-present chrome that isn’t a screen of its own.
| Element | Behavior | Version |
|---|---|---|
| Status bar / breadcrumb | Shows Show › Song › Patch when in a patch; Show › Song when in a song. Affordance-only navigation aid. | v0.9.0 |
Legend
- Shipped — tagged on GitHub, in current builds
- v0.6.0 — next version, actively scoped
- vX.Y.Z — planned, target version assigned
- v2.0+ — post-1.0 backlog
For the version-by-version exit criteria, see the Pit roadmap.