--- name: web extract description: plain shadcn-style operator dashboard for retrieval observability and query testing colors: background: "#fff" foreground: "#20242a" primary: "#24282e" primary-foreground: "#fff" secondary: "#f3f4f5" muted: "#5d6570" border: "#e0e3e7" control-border: "#c9cdd2" focus: "#525a66" error: "#982219" error-background: "#fff5f4" error-border: "#edb7b3" typography: body: fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' fontSize: "14px" fontWeight: 400 lineHeight: 1.5 heading: fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' fontSize: "20px" fontWeight: 650 lineHeight: 1.5 letterSpacing: "-.025em" section-heading: fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' fontSize: "17px" fontWeight: 600 lineHeight: 1.5 letterSpacing: "-.015em" rounded: sm: "4px" md: "6px" lg: "8px" spacing: sm: "8px" md: "16px" lg: "24px" xl: "36px" components: button-primary: backgroundColor: "{colors.primary}" textColor: "{colors.primary-foreground}" rounded: "{rounded.md}" padding: "8px 16px" height: "36px" input: backgroundColor: "{colors.background}" textColor: "{colors.foreground}" rounded: "{rounded.md}" height: "36px" --- # design system: web extract ## overview **creative north star: "plain operator dashboard"** This is a restrained, familiar admin interface for service operators inspecting retrieval behavior and testing their own queries. It uses shadcn-style primitives, system UI typography, lowercase copy, and a light neutral canvas. The visual system stays quiet so real request totals, activity rows, traces, and evidence remain the focus. The information story is totals → activity → trace, with playground → results → evidence as the parallel operator path. The first viewport prioritizes live totals and activity; the dashboard navigation is a simple two-tab form. **key characteristics:** - light neutral surfaces with a charcoal primary - compact system-ui hierarchy and tabular numerics - borders and whitespace provide structure instead of decoration - accessible focus states and reduced-motion behavior ## colors The palette is neutral-first: white surfaces, charcoal text and actions, muted gray supporting text, and a restrained red error treatment. ### primary - **charcoal action** (#24282e): primary buttons, checkbox accent, and emphasized controls. ### neutral - **white canvas** (#fff): page and control backgrounds. - **charcoal text** (#20242a): foreground and headings. - **muted gray** (#5d6570): supporting copy, metadata, and loading states. - **soft gray** (#f3f4f5): secondary surfaces and formatted json. - **border gray** (#e0e3e7): dividers, table frames, and layout rules. - **control gray** (#c9cdd2): select borders. ### named rules **the evidence-first rule.** Keep color and decoration subordinate to live totals, activity, traces, results, and evidence. ## typography **display font:** system ui (`-apple-system`, `blinkmacsystemfont`, `"segoe ui"`, sans-serif) **body font:** same system ui stack **character:** compact, legible, and operational rather than branded or editorial. ### hierarchy - **heading** (650, 20px, 1.2): page title and login title. - **section heading** (600, 17px, 1.3): activity and inspection sections. - **subheading** (600, 14px): component labels and configuration group headings. - **body** (400, 14px, 1.5): general interface copy and data. - **metadata** (400, 12–13px): muted labels, timestamps, and supporting context. - **metric** (550, 25px): live totals; use tabular numerics. ### named rules **the lowercase operator rule.** Interface copy remains lowercase, including labels, tabs, statuses, and actions. ## layout Use a centered shell with a 1320px maximum width and 36px horizontal padding on wide screens. The header is a flex row with a bottom border and 24px vertical padding. Metrics form a four-column band with vertical separators, 20px vertical padding, and 12px lower margin. The dashboard uses a two-tab activity/playground split; the playground becomes a 330px form column and a flexible output column separated by a 40px gap. At 850px, shell padding reduces to 20px and metrics become two columns; at 650px, padding is 16px, metrics remain two columns, and playground columns stack. ## elevation & depth The system is restrained and border-led, with white/soft-gray tonal contrast, 1px borders, dividers, and spacing doing most of the structural work. Standard shadcn controls and tabs may use small default shadows; they are subtle state/support treatments, not decorative elevation. Error notices use a pale red surface and border. ### named rules **the restraint rule.** Use borders, tonal layering, and whitespace first; keep standard control shadows small and subordinate. ## shapes Controls and notices use modest rounding: 4px for summaries, 6px for selects and notices, and 8px for table frames. Borders are 1px and gray. Tables clip overflow inside an 8px frame; long request content wraps or scrolls rather than forcing the page wider. ## components ### buttons - **shape:** modest 6px radius; compact shadcn sizing. - **primary:** charcoal background, white text, and familiar inline padding. - **hover / focus:** preserve the quiet palette; focus-visible uses a 2px #525a66 outline with 3px offset. - **secondary / ghost:** outline and ghost variants support refresh, pagination, close, and sign out without competing with data. ### cards / containers - **corner style:** table frames 8px; notices and controls 6px. - **background:** white canvas with soft-gray secondary surfaces. - **shadow strategy:** small standard shadcn shadows may support controls and tabs; avoid ornamental elevation. - **border:** 1px #e0e3e7. - **internal padding:** 12–24px depending on notice, result, or inspector context. ### inputs / fields - **style:** white background, 1px #c9cdd2 border, 6px radius, 36px minimum height for selects. - **focus:** 2px #525a66 focus-visible outline with 3px offset. - **error:** pale red #fff5f4 background, #edb7b3 border, and #982219 text. ### navigation - **style:** two familiar tabs, `activity` and `playground`, with lucide icons and lowercase labels. Keep the tab list compact and below the overview totals. ### activity table Use a bordered, horizontally scrollable table with query/urls first, then endpoint, outcome, caller, and time. A selected row opens request inspection below the table; traces are progressive detail, not a separate visual world. ## do's and don'ts ### do: - **do** keep the first viewport focused on real totals and request activity. - **do** use system-ui text, lowercase copy, tabular numerics, and muted metadata. - **do** use borders, whitespace, and tonal contrast to organize operator data. - **do** preserve visible keyboard focus and reduced-motion behavior. ### don't: - **don't** introduce a custom visual identity, decorative hero treatment, or overdesigned dashboard chrome. - **don't** use ornamental shadows, gradients, or bright accent colors to compete with evidence. - **don't** hide trace, outcome, or source details behind ornamental interactions. - **don't** canonize one-off lucide icons or page-specific copy as broader visual tokens.