Files
Chronos/docs/ui/DESIGN.md
T
Claude 739d51eb7e test(app): Arabic shell, toasts, chrome names and paddings; RTL captures are drawn mirrored
- Smoke tests: the main window opens mirrored when Arabic is applied before it exists, directional icons
  follow while other glyphs, the logo, the preview surface and the charts do not; the shell behind the
  first-run dialog is disabled; toasts draw, are named and close after their action; caption buttons,
  the job bar and the pause button have names; text boxes pad once.
- --capture draws right-to-left windows through the window's mirror, as the Uploader and Setup do.
- DESIGN §5 states the directional icon rule and the left-to-right islands.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-06 08:10:36 +00:00

125 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Titano — 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 (`Titano.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 is Light-only.
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 128 px (collapses to 48 px icons); 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.
- **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 `Titano.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).
## 6. App icon (`branding/`)
`titano.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: `titano-server.svg` (rack badge), `titano-uploader.svg`
(up-arrow badge), `titano-mono.svg` (white, no plate, for the tray). PNG renders at
16/32/48/64/128/256 are reference output; `Titano.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 Sequence editor | Exposure tab, wipe compare, curves, advisor Auto pills |
| `Export.html` | §12.3 / §11.4 | preset cards with size/time estimate, Output panel, batch |
| `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, 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): About, Login dialog, the other editor
tabs (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.