okami.mom/web-extract-go

git clone https://git.nkp.pet/okami.mom/web-extract-go

nekomimi.petweb-extract: the Go service running on the Mac mini (vassago)5a90548

main
7.2 KiB163 linesraw

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.
1---
2name: web extract
3description: plain shadcn-style operator dashboard for retrieval observability and query testing
4colors:
5  background: "#fff"
6  foreground: "#20242a"
7  primary: "#24282e"
8  primary-foreground: "#fff"
9  secondary: "#f3f4f5"
10  muted: "#5d6570"
11  border: "#e0e3e7"
12  control-border: "#c9cdd2"
13  focus: "#525a66"
14  error: "#982219"
15  error-background: "#fff5f4"
16  error-border: "#edb7b3"
17typography:
18  body:
19    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif'
20    fontSize: "14px"
21    fontWeight: 400
22    lineHeight: 1.5
23  heading:
24    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif'
25    fontSize: "20px"
26    fontWeight: 650
27    lineHeight: 1.5
28    letterSpacing: "-.025em"
29  section-heading:
30    fontFamily: '-apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif'
31    fontSize: "17px"
32    fontWeight: 600
33    lineHeight: 1.5
34    letterSpacing: "-.015em"
35rounded:
36  sm: "4px"
37  md: "6px"
38  lg: "8px"
39spacing:
40  sm: "8px"
41  md: "16px"
42  lg: "24px"
43  xl: "36px"
44components:
45  button-primary:
46    backgroundColor: "{colors.primary}"
47    textColor: "{colors.primary-foreground}"
48    rounded: "{rounded.md}"
49    padding: "8px 16px"
50    height: "36px"
51  input:
52    backgroundColor: "{colors.background}"
53    textColor: "{colors.foreground}"
54    rounded: "{rounded.md}"
55    height: "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.