okami.mom/web-extract-go
git clone https://git.nkp.pet/okami.mom/web-extract-go
5a90548
main
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,
activityandplayground, 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.
1--- 2name : web extract 3description : plain shadcn-style operator dashboard for retrieval observability and query testing 4colors : 5background : "#fff" 6foreground : "#20242a" 7primary : "#24282e" 8primary-foreground : "#fff" 9secondary : "#f3f4f5" 10muted : "#5d6570" 11border : "#e0e3e7" 12control-border : "#c9cdd2" 13focus : "#525a66" 14error : "#982219" 15error-background : "#fff5f4" 16error-border : "#edb7b3" 17typography : 18body : 19fontFamily : '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' 20fontSize : "14px" 21fontWeight : 400 22lineHeight : 1.5 23heading : 24fontFamily : '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' 25fontSize : "20px" 26fontWeight : 650 27lineHeight : 1.5 28letterSpacing : "-.025em" 29section-heading : 30fontFamily : '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif' 31fontSize : "17px" 32fontWeight : 600 33lineHeight : 1.5 34letterSpacing : "-.015em" 35rounded : 36sm : "4px" 37md : "6px" 38lg : "8px" 39spacing : 40sm : "8px" 41md : "16px" 42lg : "24px" 43xl : "36px" 44components : 45button-primary : 46backgroundColor : "{colors.primary}" 47textColor : "{colors.primary-foreground}" 48rounded : "{rounded.md}" 49padding : "8px 16px" 50height : "36px" 51input : 52backgroundColor : "{colors.background}" 53textColor : "{colors.foreground}" 54rounded : "{rounded.md}" 55height : "36px" 56--- 57 58# design system: web extract 59 60## overview 61 62**creative north star: "plain operator dashboard"** 63 64This 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. 65 66The 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. 67 68**key characteristics:** 69- light neutral surfaces with a charcoal primary 70- compact system-ui hierarchy and tabular numerics 71- borders and whitespace provide structure instead of decoration 72- accessible focus states and reduced-motion behavior 73 74## colors 75 76The palette is neutral-first: white surfaces, charcoal text and actions, muted gray supporting text, and a restrained red error treatment. 77 78### primary 79- **charcoal action** (#24282e): primary buttons, checkbox accent, and emphasized controls. 80 81### neutral 82- **white canvas** (#fff): page and control backgrounds. 83- **charcoal text** (#20242a): foreground and headings. 84- **muted gray** (#5d6570): supporting copy, metadata, and loading states. 85- **soft gray** (#f3f4f5): secondary surfaces and formatted json. 86- **border gray** (#e0e3e7): dividers, table frames, and layout rules. 87- **control gray** (#c9cdd2): select borders. 88 89### named rules 90**the evidence-first rule.** Keep color and decoration subordinate to live totals, activity, traces, results, and evidence. 91 92## typography 93 94**display font:** system ui (`-apple-system`, `blinkmacsystemfont`, `"segoe ui"`, sans-serif) 95**body font:** same system ui stack 96 97**character:** compact, legible, and operational rather than branded or editorial. 98 99### hierarchy 100- **heading** (650, 20px, 1.2): page title and login title. 101- **section heading** (600, 17px, 1.3): activity and inspection sections. 102- **subheading** (600, 14px): component labels and configuration group headings. 103- **body** (400, 14px, 1.5): general interface copy and data. 104- **metadata** (400, 12–13px): muted labels, timestamps, and supporting context. 105- **metric** (550, 25px): live totals; use tabular numerics. 106 107### named rules 108**the lowercase operator rule.** Interface copy remains lowercase, including labels, tabs, statuses, and actions. 109 110## layout 111 112Use 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. 113 114## elevation & depth 115 116The 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. 117 118### named rules 119**the restraint rule.** Use borders, tonal layering, and whitespace first; keep standard control shadows small and subordinate. 120 121## shapes 122 123Controls 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. 124 125## components 126 127### buttons 128- **shape:** modest 6px radius; compact shadcn sizing. 129- **primary:** charcoal background, white text, and familiar inline padding. 130- **hover / focus:** preserve the quiet palette; focus-visible uses a 2px #525a66 outline with 3px offset. 131- **secondary / ghost:** outline and ghost variants support refresh, pagination, close, and sign out without competing with data. 132 133### cards / containers 134- **corner style:** table frames 8px; notices and controls 6px. 135- **background:** white canvas with soft-gray secondary surfaces. 136- **shadow strategy:** small standard shadcn shadows may support controls and tabs; avoid ornamental elevation. 137- **border:** 1px #e0e3e7. 138- **internal padding:** 12–24px depending on notice, result, or inspector context. 139 140### inputs / fields 141- **style:** white background, 1px #c9cdd2 border, 6px radius, 36px minimum height for selects. 142- **focus:** 2px #525a66 focus-visible outline with 3px offset. 143- **error:** pale red #fff5f4 background, #edb7b3 border, and #982219 text. 144 145### navigation 146- **style:** two familiar tabs, `activity` and `playground`, with lucide icons and lowercase labels. Keep the tab list compact and below the overview totals. 147 148### activity table 149Use 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. 150 151## do's and don'ts 152 153### do: 154- **do** keep the first viewport focused on real totals and request activity. 155- **do** use system-ui text, lowercase copy, tabular numerics, and muted metadata. 156- **do** use borders, whitespace, and tonal contrast to organize operator data. 157- **do** preserve visible keyboard focus and reduced-motion behavior. 158 159### don't: 160- **don't** introduce a custom visual identity, decorative hero treatment, or overdesigned dashboard chrome. 161- **don't** use ornamental shadows, gradients, or bright accent colors to compete with evidence. 162- **don't** hide trace, outcome, or source details behind ornamental interactions. 163- **don't** canonize one-off lucide icons or page-specific copy as broader visual tokens.