CI / Build and test (push) Successful in 8m19s
CI / Windows tests and installer (push) Skipped
CI / YAML check (push) Successful in 7s
Release / Build, test and publish (push) Successful in 12m9s
CI / PostgreSQL 16 integration (push) Successful in 7m49s
CI / PostgreSQL 17 integration (push) Successful in 7m19s
CI / Docker image (push) Successful in 46s
Release / Server image (push) Successful in 1m14s
Owner review 1 R5 + R6. Camera rotation, mirror, flip, straighten and crop handles locked to the output; an Exposure Look group; Export output size ("proportions win"); settings format 2 with older-node gates. Also fixes project text and hashes differing between Windows and Linux.
Closes #19
Closes #20
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Alberto Balbo <alberto.balbo.96@gmail.com>
170 lines
15 KiB
Markdown
170 lines
15 KiB
Markdown
# 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, `Editor.html` two steps and the crop states one below the other; 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.
|
||
- **Setting rows** (side panels, label on the left, value or control on the right; owner review 1, R5/R6):
|
||
*number* = label, value in TextMuted with tabular figures, the slider on the line below (Straighten
|
||
−15…15° by 0.1, `−1.2°`; Crop size `85 %`, Crop X/Y `+0.40` · `Centred`); *switch* = label and a 36 × 20 switch at the
|
||
right (off = TextMuted outline and knob, on = Accent fill, OnAccent knob; `role="switch"`), one toggle is one
|
||
undo step; *icon actions* = label, the value (Rotation `90°`), then 28 px icon-only buttons (a quarter turn per press, as the user sees
|
||
the picture: the direction swaps while exactly one of Mirror and Flip is on); *info* = label
|
||
and a read-only value (Output size). A row that does not apply shows "n/a" in TextFaint with the reason in
|
||
its tooltip (Crop X when the crop fills the width, Strength when the filter is None). A **group** inside a
|
||
panel is a 1 px Stroke divider, then its name in Text.Body 600 with the group's tooltip (Look on Exposure).
|
||
- **Crop overlay** (preview, Camera step; owner review 1, R5): the box is drawn over the whole view frame (oriented,
|
||
straightened) and is always locked to the output aspect. States (tiles under the Camera screen in `Editor.html`):
|
||
- *Shown*: Crop mask on, any step: Scrim (#99000000 dark, #66000000 light) outside, 1 px TextMuted outline.
|
||
In "how it will look" mode the outside is hidden instead, as today; handles and outline still draw.
|
||
- *Editable*: Camera step, mask on (its default there) and the project editable: 1.5 px Accent outline and
|
||
8 handles (4 corners, 4 edge midpoints), 8 × 8 screen px whatever the zoom, Card fill, 1.5 px Accent stroke.
|
||
The preview tooltip becomes "Drag to move · drag a handle to resize…" (`Tooltips.Editor.Preview.CropEdit`).
|
||
- *Dragging*: rule-of-thirds lines inside the box (1 px Text at 50 %); only the overlay moves until mouse up,
|
||
which commits one undo step; Esc cancels. Corners anchor the opposite corner, edges the opposite edge
|
||
(centred on the other axis), Alt resizes about the centre; the minimum is 10 % of the largest box.
|
||
- *Straightening*: while the Straighten slider is dragged or focused, a fine 8 × 8 grid over the whole view
|
||
(1 px Text at 30 %).
|
||
- *Locked* (read-only, newer format, busy): drawn as Shown, no handles, drag pans.
|
||
Hit-test order: a handle within 6 screen px, the wipe divider, inside the box (move, SizeAll cursor), outside
|
||
(pan); inside a box that spans the view both ways a press pans while the view is zoomed, and the middle button always
|
||
pans. Cursors SizeNWSE/SizeNESW on corners, SizeWE/SizeNS on edges. Keyboard: a press on the box or Enter selects it
|
||
(2 px Accent ring outside the handles), Esc gives the arrows back to the frames; while selected, arrows move 1 %,
|
||
Shift+arrows 10 %, + and − resize 2 % about the centre. Double-click keeps Fit / 1:1.
|
||
- **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. The Camera step's orientation icons (owner review 1, R6): RotateLeft / RotateRight = a rounded
|
||
picture under a quarter-circle arrow (`turn_arrow()`), Mirror / Flip = an outline triangle and a filled one across a
|
||
dashed axis, Straighten = a tilted line over a level one with its angle arc. They describe the picture, not the
|
||
reading direction, so they never mirror in RTL.
|
||
|
||
## 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 | three parts, one below the other. Exposure step: step bar, title ▾ (Change sequence), wipe compare (the corrected side carries the look), curves, advisor Auto pills, the Look group (Filter, Strength) at the end of the panel, Previous · n / m · Next. Camera step (`#camera`): the whole view frame with a 9:16 crop being edited (handles), the zoom-keyframe curve under the filmstrip, rows Aspect · Rotation (Rotate left/right and the value) · Mirror · Flip · Straighten · Crop size · Crop X · Crop Y, the keyframes line, then Reset framing on its own line (three buttons do not fit the 292 px panel) above Optimise section · Reset (Reset framing disabled, with `ResetFramingNone`, when nothing is set). Crop overlay states: Shown, Editable, Dragging, Straightening, Locked |
|
||
| `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. Resolution edits the preset's box; the **Output size** row under it shows what is rendered: the chosen proportions fitted in the box (4K at 9:16 = 2160 × 3840; "source" keeps the preset), the preset name unchanged; when the encoder caps it, the value reads "1296 × 2304 (capped)" with `Tooltips.Editor.Export.OutputCapped`. The preview mask is the output's footprint in the view frame |
|
||
| `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; a `Queue · Scheduled` segmented control first in the toolbar (owner review 2, R10): Scheduled is a table (on switch, name, action, when, next run, last result, Run now · Edit · Reset or Delete), the selected schedule's last runs under it (Show in queue), New schedule at the toolbar's end and the editor as an in-window dialog; jobs a schedule queued carry an Accent `Scheduled` pill after their target |
|
||
| `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, Jobs › Scheduled and its editor, the Edit picker
|
||
and the other steps (Analysis, Frames, Motion, 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.
|