Solution layout, build rules with zero-package guard, in-house test framework, localization runtime, brand mark rasteriser with ICO/PNG generation, Core contracts (imaging, video, domain model, TIFF reader), Titano.Tools (make-icon, i18n, xaml-lint, package-guard) and docs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
120 lines
8.0 KiB
Markdown
120 lines
8.0 KiB
Markdown
# 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.
|
||
|
||
## 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.
|