Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
8.8 KiB
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 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 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.Nameand 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 · 41pill 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 ·▶ nrendered ·●accent Synced/Remote ·◐amber Analysing ·▲ nwarnings ·✕ nerrors. - 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 +
AccentSelectedglow; 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).
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/)
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.