Files
Chronos/docs/ui/DESIGN.md
T
Alby96andClaude Opus 5.5 8886e075b9 feat(app)!: move About into Settings as its last page
The owner asked to fold the About section into Settings to save room in the
side rail (owner review 2, R5). The rail now docks Settings alone at the
bottom; About is the last Settings page with this copy's identity: version,
build, runtime, system, licence link, third-party notice and, outside English,
the machine-translation notice with its review link.

Nothing is offered twice inside Settings: the update check, its notice and the
releases link live on Updates, the data folder and the diagnostics bundle on
Advanced, so About's duplicate buttons and its own diagnostics code are gone.
AboutViewModel stays as a plain helper owned by the shell (Chronos.App.About),
which keeps every Shell.About binding and the update check on start.

SectionKey.About, AboutView and the rail strings are removed (orphans pruned
from every culture, which also re-sorts two Setup tooltip keys); the capture,
the smoke tests, DESIGN, ARCHITECTURE, the desktop mockups and the docs that
pointed at About follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 22:48:27 +01:00

10 KiB
Raw Blame History

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.

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
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.