# Archie UI Redesign — Handoff A redesign of the Archie web UI: - a calmer **"Graphite" theme** that replaces the purple - a **new navigation**: five top-level places, with all configuration moved under Settings - new layouts for **Settings** (every section, plus Channels moved in), the **Dashboard**, **Task detail**, **Workflows**, a **New task** dialog and **Events** This folder is self-contained. Read this file first, then look at the screenshots. ``` README.md ← this spec (read it all before planning) CLAUDE_PROMPT.md ← the prompt to paste into Claude Code tokens/tokens.css ← theme as CSS custom properties (source of truth) tokens/tokens.json ← same values as JSON (for Tailwind / JS themes) screenshots/ 00-current-*.png ← how each page looks TODAY P0-navigation-map ← today → proposed navigation, and what moves where P1…P5 ← app pages: dashboard, task detail, workflows, new task, events S1…S5 ← settings: sidebar + rows, personas, tools & MCP, review drawer, channels T-theme-components ← palette, type, buttons, pills, toggles, inputs mockups/*.html ← static HTML of each screenshot; open in a browser, inspect for exact CSS source/*.dc.html ← original design-canvas sources (reference only, needs a runtime that isn't included) ``` > **How to treat this.** The mockups are a target, not a pixel spec. They are static HTML > written by hand; the app's framework, component library, router and data model win. Where the > mockups assume something the backend doesn't have, flag it rather than faking it. > Text in `[square brackets]` in a mockup is a placeholder for real data. --- ## 1. Problems being fixed (all pages) 1. **Purple everywhere.** Purple-tinted backgrounds, borders, buttons, checkboxes, bars and links all compete for attention. 2. **Repeated chrome.** Every settings card has its own "Connecting" pill, "Restart required" pill, "Version 1", "Save changes" and "History". Workflows and Channels repeat the pattern. 3. **Raw config shapes leak through.** Durations as Go strings (`1h0m0s`, `0s`), bytes as `2000000`, maps as key/value boxes, secret refs as two separate Engine/Key text fields, booleans as bare checkboxes with no explanation. 4. **No descriptions.** Almost no field says what it does. 5. **Things live in the wrong place.** Channels (configuration) sits under Work; "Start work" sits inside the workflow editor page; the Channels audit table only covers Channels; workflow analytics mix every workflow together. 6. **The most important information isn't first.** The Dashboard opens with quality gates; the "3 need you" count is a small button. ## 2. Navigation (screenshot `P0-navigation-map.png`) **Top bar (every page):** logo · **Dashboard · Tasks · Workflows · Events · Settings** · spacer · "Jump to…" search (⌘K) · **New task** button · connection pill · account avatar. The Work and System dropdowns go away. The floating chat button stays, restyled (neutral fill, accent icon). | Place | Job | Contains | |---|---|---| | Dashboard | What needs me right now | Needs-you queue, live activity, health (quality gates, tokens) | | Tasks | The work | Task list (filter by state), task detail | | Workflows | How work runs | List with runs/success/cost, definition editor, Performance and Runs tabs | | Events | What comes in | Inspector, Mappings, Bindings | | Settings | Everything you configure | **Agents:** Personas, Schedules, Scheduling policy · **Integrations:** Channels, Tools & MCP, Plugins · **Runtime:** Container runtime · **History** | What moves: | What | Moves to | Why | |---|---|---| | Start work card (Workflows page) | **New task** dialog from the top bar and ⌘K | Starting work isn't editing a workflow | | Channels (Work menu) | Settings › Integrations › Channels | It's configuration; gets the shared setting rows and save flow | | Audit table (Channels page) | Settings › History, filterable by section | One change log for all settings; replaces per-card History links | | Per workflow table | Columns in the Workflows list | Stats next to the workflow you're about to open | | Slowest stages · Most failures | Workflow › Performance tab | Scoped to the selected workflow | | Connecting / Version pills on every card | One connection status in the top bar | Connection is global | | Settings "Managed elsewhere" row | Removed; those are the Events tabs | They already live there | | Task "Attempt 2 is not recorded" column | Attempts list in the task side rail | Shows every attempt and its outcome | The dropdown contents of today's Work and System menus were inferred from screenshots. **Check the router** and place any page not covered here using the same rule: configure → Settings, act on → where the work is. ## 3. Theme All values are in `tokens/tokens.css`. Rules that matter more than the hex values: - **One accent, used sparingly.** Default sage `#86b5a0`. Only for: active nav/list item (2px inset left bar + raised background), active tab underline, focus borders/rings, "edited" dots and counts, toggle "on" track, primary button fill, success text, the "live"/"running"/"connected" dot, and positive bars. Never for backgrounds, headings or borders at rest. - Keep the accent a **single variable** so it can be swapped (sage / steel `#8aa4c2` / sand `#d4a373` / muted violet `#a397c9`). - **Neutral, slightly warm greys**, no hue tint on surfaces and no background gradients. Hierarchy comes from surface steps and borders. - **Amber = needs attention** (parked, awaiting reply, applies after restart, connecting). **Red = failed / destructive / risky** (errors, delete, unrestricted filesystem). No other hues except the agent state swatches in the tokens. - **Fonts:** IBM Plex Sans for UI; **IBM Plex Mono for every machine value**: config values, IDs, keys, env var names, image refs, durations, paths, event names, task numbers, log lines, counts in tables. - Text contrast: `--text-3` is the dimmest text allowed, and only for hints and captions. ## 4. Components (screenshot `T-theme-components.png`) Build these once and reuse everywhere. Heights are 36px unless noted. | Component | Spec | |---|---| | **Button** | primary (accent fill, `--text-on-accent`), secondary (`--raised` + `--border-button`), ghost (transparent, `--text-2`), destructive (red text, transparent). 13px/500, radius 6. Small variant 30px/12px. **One primary per view.** | | **Text input** | `--bg` fill, `--border-input`, radius 6, mono 13px. Focus: accent border + 3px `--accent-ring`. Invalid: red border + 12px red message. | | **Input with unit** | input + attached suffix (`MB`, `sec`, `chars`) or unit ``, `