# Omnius browser instrument design system

Version 1 · 2026-10-16 · implementation contract

Companion documents: [reconstruction plan](dashboard-reconstruction-plan.md) and [durable implementation checklist](dashboard-TODO.md).

## Intent and references

Reconstruct the existing daemon dashboard around deliberate negative space, implied boundaries, muted monochrome readings and explorable operational modules. The user's flight-instrument and sparse dot-grid references establish composition, not decorative text or fictional telemetry. References supplied locally: `c86dda8010aea451db238b027854c6a6.jpg`, `82182e9d241909503a2daa9ef735de8d.jpg`, and `/home/roko/Desktop/OPENTUI_INSTRUMENT_STYLEGUIDE.md`. This browser contract adapts their geometry to accessible HTML; native OpenTUI remains a separate renderer.

Broad open space belongs between groups. Related readings remain compact. Do not fill blank areas with ornamental grids, empty cards, duplicated descriptions, status badges, invented counters or redundant headings. Every visible module must support an actual task. Most sections have no enclosing box. Thin rules and alignment imply boundaries; complete borders belong primarily to controls, selected modules and dialogs. No diagonals, rounded corners, gradients, glows or shadows.

## Grayscale hierarchy

Surface levels express ownership, rather than arbitrary alternating strips. Use one stylesheet and semantic tokens, including all dynamically rendered content.

| Token / purpose | Dark | Light |
| --- | --- | --- |
| Canvas | `#141414` | `#f1f1f1` |
| Navigation / persistent left panel | `#101010` | `#e7e7e7` |
| Main working surface | `#171717` | `#f5f5f5` |
| Auxiliary settings / subordinate region | `#1c1c1c` | `#eeeeee` |
| Hover / selected module | `#292929` | `#dddddd` |
| Modal / elevated inspection | `#242424` | `#fafafa` |
| Primary text | `#d6d6d6` | `#353535` |
| Secondary text | `#b0b0b0` | `#595959` |
| Muted readable text | `#999999` | `#606060` |
| Decorative hairline | `#414141` | `#c5c5c5` |
| Control boundary / focus | `#898989` | `#777777` |
| Selected action fill / text | `#cccccc` / `#171717` | `#454545` / `#fafafa` |

Normal text must retain at least 4.5:1 contrast on its actual surface. Focus and essential control outlines need 3:1 contrast. Decorative lines may be subtler. Never use low-contrast decorative gray for required labels. State is conveyed in words plus geometry, not color alone. Light, dark and system modes share the same hierarchy. Media itself keeps its original colors.

## Typography and spacing

Use locally bundled **Departure Mono**, from the user's `DepartureMono-1.500` distribution, with its SIL Open Font License. Prefer its WOFF2 web artifact; no external font request. `font-display: swap`; native monospace fallback. Avoid synthetic heavy weights. The supplied font recommends multiples of 11px for pixel-perfect rendering; use 22px titles and prioritize readable 14px body text over shrinking controls to 11px. Base text 14px with approximately 1.6 line height; compact labels 11–12px with modest tracking; page titles 20–22px. Preserve mixed-case prose, filenames, paths and prompts. Uppercase is reserved for short navigation/section labels. Tabular numbers align readings. Do not shrink text to fit a crowded layout.

Spacing scale: 4, 8, 12, 16, 24, 32, 48, 64px. Related field label/control gap 8px; field group gap 16–24px; section gap 32–48px; desktop page gutters 32–48px. Narrow screens use 16px gutters and 24–32px group gaps. Reading width approximately 72ch; workbench preview may use the remaining width. Surplus width creates breathing room, not oversize inputs or a wall of boxed cells.

## Shared component grammar

| Component | Contract |
| --- | --- |
| Shell | Quiet navigation surface; resizable/reopenable left boundary; main canvas; compact mobile drawer with real close control. |
| Route heading | Small identity label, concise title, one useful sentence at most. Leave open space before the working area. Actions aligned beside heading on wide screens and below on narrow screens. |
| Section | Unboxed semantic section with heading and optional action; dotted or solid rule only when separating distinct responsibilities. |
| Auxiliary region | Subordinate grayscale surface and padding; avoid repeated border-in-border cards. |
| Field | Visible label, control, concise help/error. No placeholder-only labels. Seed/steps/duration group under expandable parameters when secondary. |
| Button | Sharp small rectangle; primary action muted inverse; secondary quiet outline; text action for navigation; clear focus. Minimum 36px desktop / 44px coarse-pointer or narrow viewport targets. |
| Module browser | A dialog containing selectable model modules and a nested detail view, not a raw model select. Search/filter, meaningful state, exact ownership and back navigation. |
| Selected model | One compact composer trigger with name and state; opens reusable module browser. No duplicate model dropdown. |
| Detail list | Label/value pairs with natural wrap; optional dotted leaders on wide screens. Paths wrap and remain selectable. Unknown differs from zero. |
| Status | Local to the affected operation. Idle, queued, downloading, ready, failed and interrupted have literal text. Real byte progress only; indeterminate progress when total is unknown. |
| Media result | Actual validated preview, concise metadata, Download and Delete saved media actions. No giant empty preview placeholder. |
| Library | Bounded pages and lazy previews; filters grouped separately from results; responsive tiles with readable caption/actions; stable item identity. |
| Modal | Distinct gray surface, dim backdrop, restrained corner/rule framing, bounded viewport scroll. Escape/outside close, focus trap and restoration; destructive confirmation names item and deletion scope. |
| Empty / error | One explanation and an applicable next action. Do not pretend failed requests are empty successful collections. |
| Tables / telemetry | Compact rows within spacious sections; right-aligned numbers with units; scroll only inside an explicitly bounded data region when unavoidable. |

## Generative composer and nested model exploration

Image, video, sound and music share one composer anatomy: task mode → selected model module → prompt → optional parameters → operation status → output. Audio/video/live analysis retain separate inputs appropriate to analysis; do not expose generation parameters there.

Model exploration opens a modal from the composer. It contains searchable modules for the current media kind. Opening a module reveals capabilities, backend, known dependencies, installation state, cache locations, measured bytes and supported actions. Selecting it returns to the composer without starting inference or a download. Returning to the module list preserves the current media kind. Automatic model selection is a deliberate module with an explanation of its first-run behavior.

Weights and generated outputs are separate resources:

- **Download weights:** an explicit network/disk-only job. It must not reuse prepare/prewarm operations that load CUDA. Show pending/running/complete/failed/interrupted state; do not label partial cache presence as installed. Make unsupported/custom provider management explicit.
- **Delete cached weights:** confirmation identifies repository and measured cache location. Shared dependencies are identified. Busy generation/download/relocation blocks deletion. Catalog entries remain available for later downloads. Never present removal of a catalog adapter as deletion of its weights.
- **Automatic downloads:** state before generation that first use can fetch weights and runtime dependencies. Show the resolved model store root, not a hardcoded home path. Explain existing disk-management behavior accurately.
- **Delete saved media:** confirmation names the saved gallery item and metadata. Deleting a gallery copy must not claim to delete unrelated source/work files or model weights. Download and delete operate on authenticated, validated immutable item identity.
- **Store management:** an auxiliary inspection area in the model browser shows current root, gallery root and explicit relocation/migration controls. It should not dominate the prompt workspace.

Voice shares the field/module/inspection grammar while preserving its actual ASR, live microphone, clone and TTS service contracts. Do not imply that every voice engine uses the same storage or download API.

## Interaction, responsiveness and performance

All actions keyboard accessible. Modal focus remains contained; close restores invoking control. Tabs implement tab semantics and arrow/home/end behavior, or use ordinary buttons without misleading ARIA. Native disclosures keep advanced settings accessible. No hover-only actions. Errors are announced through local live regions. Reduced motion disables transitions; ordinary transitions should be subtle and short.

Test 360, 768 and 1440px widths, both themes, short windows and zoom. Main document must not overflow horizontally. Long paths and Unicode names wrap. Forms stack in source order. Mobile navigation remains reopenable and controls do not cover composer or dialog actions. Dialogs scroll within available height.

No new UI framework, GPU visualization dependency, remote fonts or per-item polling. Bound gallery preview concurrency and pagination. Poll only visible active jobs, stop on terminal state/close, and preserve meaningful failure states. Reuse authenticated media receipts and blob lifecycle. Preserve all same-origin base-path, streaming, session, authentication and daemon Stop behavior.

## Acceptance

Every route and nested module uses these primitives, including error/empty/loading states and dynamic Voice/settings forms. Screenshots come from the actual production HTML in an isolated Chromium fixture; no generated mockups. Verify actual pointer/keyboard behavior, measured contrast and overflow, not only class names. Keep implementation and evidence status in `dashboard-TODO.md`.
