# Chronos — Design reference for Claude Code Companion to `docs/BRIEF.md` §12 (UI spec). Suggested repo placement: `docs/ui/DESIGN.md` (this file), `docs/ui/mockups/*.html` (open in any browser; each file is one screen at its natural size, links between screens work), `branding/` (icon sources). The mockups are the visual target; where a mockup and the brief disagree on behaviour, the brief wins; where they disagree on looks, the mockup wins. ## 1. Tokens → WPF resource dictionary (`Chronos.App/Themes/Dark.xaml`, `Light.xaml`) | Key (SolidColorBrush) | Dark | Light | Use | |---|---|---|---| | `Brush.Bg` | #1F1F23 | #F3F3F3 | window background | | `Brush.Chrome` | #1A1A1E | #FFFFFF | title bar, rail, status bar, web sidebar | | `Brush.Surface` | #26262C | #FFFFFF | panels, toolbars, dialogs | | `Brush.Card` | #2F3038 | #FFFFFF | cards, inputs, buttons, hovered rows | | `Brush.Stroke` | #3E404A | #E5E5E5 | 1 px borders and dividers | | `Brush.Text` | #F2F3F5 | #1A1A1A | primary text | | `Brush.TextMuted` | #A9AEB9 | #616161 | secondary text, labels | | `Brush.TextFaint` | #7B818E | #9E9E9E | hints, column headers, disabled | | `Brush.Accent` | #4CC2FF | #0067C0 | primary button, active rail edge, links, Auto | | `Brush.OnAccent` | #0B1B24 | #FFFFFF | text on accent | | `Brush.AccentSelected` | rgba(76,194,255,.25) | #E8F1FA | selection glow / selected nav | | `Brush.Sun` | #F5A524 | #E08A1E | manual slider track, uploader accent, icon sun | | `Brush.Success` | #35C48F | #0F7B4F | analysed, in sync, done | | `Brush.Warning` | #E8B339 | #9A6700 | warnings, destructive outline | | `Brush.Error` | #F0625D | #C42B1C | errors, failed | | `Brush.Region` | #5AD1C8 | #1A9E95 | sky/landscape region masks only | Dark is the client default; Light follows the OS setting; the web admin follows the browser's colour scheme, with a Light/Dark toggle in its header. Never use colour alone to carry state: pair it with a glyph (● ○ ◐ ▲ ✕ ▶) or a word. ## 2. Type (Segoe UI Variable, fallback Segoe UI; `FontSize` keys) `Text.PageTitle` 18/600 · `Text.Title` 16/600 · `Text.Section` 14/600 · `Text.Body` 13/400 · `Text.Secondary` 12/400 muted · `Text.Chip` 11/400. Line heights 24/22/20/18/16/14. Numbers in tables use tabular figures (`Typography.NumeralAlignment="Tabular"`). Layout must survive +40 % text width (de, fi): no fixed-width labels, `MinWidth` only. ## 3. Spacing, radii, sizes Spacing scale 4 · 8 · 12 · 16 · 20 (`Thickness` keys `Space.1`…`Space.5`). Radii: 6 controls · 8 cards/panels · 12 pills · 12 modal dialogs. Controls 32 px tall, 44 px minimum width, 12 px horizontal padding; compact row buttons 26–28 px. Rail 200 px (collapses to 48 px icons with ≡ or Ctrl+B, the tooltips then naming each section; the choice is kept; owner review 1); title bar 34; job bar 40; toolbar 56; status bar 30; table rows 36–40 (52 in the web admin); side panels 320 px; settings section list 200 px. Label column left of controls: 116 px in panels, 180 px in Settings. ## 4. Controls and states (see `Components.html`) - **Button**: Card fill, Stroke border. Hover +6 % lightness, pressed −6 %, focus = 2 px Accent ring outside. **Primary** (Accent fill, OnAccent text, 600) — one per screen. **Destructive** = Warning outline, transparent fill, never a primary. **Subtle** = no border until hover. **Toggled** = Accent text + Accent border. **Disabled** = 40 % opacity and the tooltip says why. Icon-only buttons carry `AutomationProperties.Name` and a tooltip. - **Inputs**: Card fill, Stroke border, Accent border on focus, Error border when invalid with the message in the tooltip (never a line of text under the field). Enter commits, Esc reverts. - **Slider — Auto/manual** (brief §10.4): Auto state = Accent track, dimmed thumb, an `Auto · 41` pill at the right whose tooltip gives the advisor's reason; touching it turns the track Sun (manual), shows the value, and a `⟲` reset button returns to Auto. Not applicable = greyed value "n/a" with the reason in its tooltip. - **Status glyphs**: `●` green Analysed · `○` faint Not analysed · `●` Proxies · `▶ n` rendered · `●` accent Synced/Remote · `◐` amber Analysing · `▲ n` warnings · `✕ n` errors. - **Chips**: 24 px pills, Card fill, Stroke border; selected/recommended = Accent border and text. - **Progress**: 6 px bar, Accent fill, text to the right; indeterminate = sliding highlight. - **Tooltip**: light on dark (#F2F3F5 on dark, #1A1A1A text), 12 px, one line: action + cost + shortcut ("Read every frame again · about 6 min · Ctrl+Shift+A"); 400 ms delay; ≤ 200 chars. Every interactive element has one. There is no other explanatory text in the UI. - **Dialog**: Surface fill, Stroke border, radius 12, 24 px shadow, two buttons maximum, safe action left and default, destructive on the right with typed confirmation for formatting. - **Toast**: bottom-right, 420 px, Card fill with a 3 px Accent left edge, one action button, 8 s, hover pauses. Used for card insertion, render done, server messages. - **Job bar**: 40 px strip under the title bar in every client screen: current job, progress, time left, pause; hidden when idle only in the editor (it shows "Ready" elsewhere). - **Rail item**: 36 px; active = Card fill + 3 px Accent left edge; badge = Accent pill with the count of things needing attention. Library, Import, Edit, Archive, Jobs and Server at the top, Settings alone at the bottom: no ⓘ About entry, About is the last Settings section (owner review 2, R5). - **Step bar** (Edit, owner review 1): one row of equal 36 px cells under the editor's header, one per step, 4 px padding: a 22 px badge, the name (about 82 px at the 1200 px minimum, an ellipsis beyond) and a 1 px Stroke connector to the next step. Badge = the number in a Stroke ring (to do), `✓` Success (done), `▲` Warning (attention), `◐` Warning (running), `○` faint (waiting): each status has its own glyph, so colour never carries it alone. Current step = 2 px Accent underline and a semibold name; visited steps' names in Text, the others muted. The tooltip names the step, then what it is for, its state and its shortcut (Alt+n). Previous · n / m · Next sit under the settings column: both buttons whole, the counter giving way. - **Cards** (Library): 236 px wide, thumbnail 16:9, count badge top-right, checkbox top-left on hover/selection, selected = Accent border + `AccentSelected` glow; hover scrubs the thumbnail. - **Tables**: header 11 px faint, sortable; rows Card fill on hover; numbers right-aligned, tabular; virtualised beyond 200 rows; row actions are 26 px buttons revealed on the row. ## 5. Icons 16 px, 1.5 px strokes, round caps and joins, `currentColor`, drawn as `PathGeometry` / `DrawingImage` resources in `Chronos.App/Icons/Icons.xaml` (source SVGs in `branding/ui-icons/` if generated by a tool). No icon fonts, no emoji in shipped UI (the mockups use a few glyphs only as placeholders: replace ⟳ ▾ ✕ ■ ❚❚ ≡ with drawn icons). Directional icons mirror in RTL: `IconData.IsDirectional` marks the glyphs that point along the reading direction (back/forward, chevrons left/right, external link, start-aligned lines); `ui:Bidi.IsDirectional` overrides it for a subtree (a ▶ used as "next", a chevron on a left-to-right time axis). Every other glyph (clocks, media controls, the ▶ rendered status) and the brand mark keep their drawn orientation. Photos, previews, charts, numbers, paths and templates are left-to-right islands (`FlowDirection="LeftToRight"` on the smallest element holding them). Category charts without a time axis (horizontal bars, stacked bars) still lay out from the reading side inside their island: labels on the reading side, bars growing away from it; time axes and month grids never flip. `branding/ui-icons/icons.py` is the one source: it writes `Icons.xaml` and the web admin's `icons.js`. Settings is a toothed gear (8 teeth, outer radius 6.5, valleys on 4.6, centre hole 1.7: `gear()` in `icons.py`); a circle with rays is the Sun icon only. ## 6. App icon (`branding/`) `chronos.svg` is the master: 256 plate radius 56 #1A1A1E, ring r 92, 12 ticks of 12° with 18° gaps, stroke 20 round caps, opacity 0.14 → 1.0 clockwise from 12 o'clock, sun disc at (152,104) r 30 #F5A524. Variants: `chronos-server.svg` (rack badge), `chronos-uploader.svg` (up-arrow badge), `chronos-mono.svg` (white, no plate, for the tray). PNG renders at 16/32/48/64/128/256 are reference output; `Chronos.Tools make-icon` must regenerate ICO/PNG from the SVG geometry (no raster assets checked in as sources). Badges only at ≥ 48 px. ## 7. Screen-by-screen notes (mockup → brief section) | Mockup | Brief | Notes | |---|---|---| | `Main.html` | §12.2 Library | grid/list, year·camera·status filters, selection panel | | `Editor.html` | §12.3 Edit | Exposure step: step bar, title ▾ (Change sequence), wipe compare, curves, advisor Auto pills, Previous · n / m · Next | | `Export.html` | §12.3 / §11.4 | the Export step: step bar with Export current, preset cards with size/time estimate, Output panel, batch, Previous · 8 / 8 · Next sequence | | `Import.html` | §12.4 / §13 | card profile, sessions, plan, verification, after-import actions | | `Archive.html` | §12.5 | tree, mass operations, stats, verify/rebuild, maintenance | | `Jobs.html` | §12.6 | filters, queue order, expandable log, retry/open/folder | | `Server.html` | §12.7 / §14 | connection with TOFU fingerprint, account and quota, render node, sync table, conflicts | | `Settings.html` | §12.8 | section list (About last, §12.9), Rendering section, encoder table, self-test | | `Welcome.html` | §12.1 | first run: local archive / adopt folder / connect; consent line; card toast | | `Admin.html` | §14.7 | dashboard; sidebar: pages from the top, Settings docked at its foot above the account, no About (the last group of Settings) | | `AdminUsers.html` | §14.7 | users table, roles, quotas, temporary password, render-node right | | `Uploader.html` | §15 | single window, watch folder, queue, tray | | `Components.html` | §12.1 | the control kit above, with hex values and state rules | | `Icon.html` | §17 | construction, sizes, variants, wordmark | Missing on purpose (build from the brief and this kit): the Settings › About page, Login dialog, the Edit picker and the other steps (Analysis, Frames, Motion, Camera, Time, Stack), Import "Show plan", Archive rebuild dialog, the admin Archive/Jobs/Settings/Logs pages. Reuse the shell and the kit; do not invent new colours.