Agent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
JavaScript agent-skillsai-agentsanti-slopclaude-codecodexcursordesign-systemfrontendlanding-pageui-designweb-design
v2.1 (wip): app screens round-1 fixes
Leonxlnxb2770b024c77
diff --git a/skills/taste-skill/SKILL.md b/skills/taste-skill/SKILL.mdindex aa048b4..3cf8e62 100644--- a/skills/taste-skill/SKILL.md+++ b/skills/taste-skill/SKILL.md@@ -448,8 +448,9 @@ open collections could not be searched.| `references/critique.md` | Step 8. How to look, how to score, what to fix first. || `references/tells.md` | The dated registry of generated-page tells and what each is replaced by. || `references/research.md` | The study: method, numbers, what the best and worst sites do. Cite it, do not guess. |-| `scripts/draw.mjs` | Deals and reprints the direction; `--photos`, `--site <id>` for more references. |+| `scripts/draw.mjs` | Deals and reprints the direction; `--photos`, `--site <id>` for more references; `--app` deals an app style instead. || `scripts/assets.mjs` | Step 6: searches open collections for real pictures of the subject's world; `--get` downloads with the credit, `--credits` prints them. || `scripts/lint.mjs` · `scripts/inspect.mjs` | The gate. || `assets/base.css` · `assets/base.js` | An optional neutral foundation to build on. |-| `library/` | The data the draw reads: directions, heroes, sections, type systems, palettes, photographs, studied sites, motions. Do not read it whole; use the script. |+| `assets/app.css` · `assets/charts.js` | For app screens: a neutral shell, panels, tables and controls, and small SVG charts drawn to the app rules. |+| `library/` | The data the draw reads: directions, heroes, sections, type systems, palettes, photographs, studied sites, motions, and the app styles, shells and screen patterns (`app.json`). Do not read it whole; use the script. |diff --git a/skills/taste-skill/assets/charts.js b/skills/taste-skill/assets/charts.jsindex d5cfdda..353bd2a 100644--- a/skills/taste-skill/assets/charts.js+++ b/skills/taste-skill/assets/charts.js@@ -8,6 +8,10 @@// Charts.bars(el, { labels, values, highlight: 6, format }) one bar may carry the accent// Charts.ring(el, { value: 0.72, label: '72%', sub: 'of capacity' }) a progress ring with its total inside// Charts.barList(el, [{ label: 'Berlin', value: 412 }, …], { format }) a ranked list where the row is the bar+// Charts.plan(el, [{ label: 'Groceries', planned: 600, spent: 412, committed: 60 }, …]) planned against spent+// Charts.bullet(el, [{ label: 'Bonds', value: 0.31, target: 0.25 }, …]) share against a target+// line/bars also take annotations: [{ at: index, label: 'Deploy a3f09c1' }] and reference: { value, label }+// line takes step: true for a balance that only changes on given days// Every chart gets role="img" and an aria-label that states what it shows.(() => {const NS = 'http://www.w3.org/2000/svg';@@ -53,11 +57,26 @@const n = xLabels.length, every = n <= 8 ? 1 : Math.max(1, Math.ceil(n / 6));xLabels.forEach((lab, i) => { if (i % every && i !== n - 1) return; if (i === n - 1 && (n - 1) % every && (n - 1) % every < every / 2) return; const t = svg('text', { x: x(i), y: h - padB + 18, 'text-anchor': i === 0 ? 'start' : i === n - 1 ? 'end' : 'middle', 'font-size': 12, fill: ink }, g); t.textContent = lab; });}- function line(el, { labels, series, format = fmt.int, height = 220, fill = false, min }) {+ // Marks that explain the data: a 1px tick with a short label at an index (a deploy, a campaign), and a+ // dashed reference line with its label at the right end (a budget, an SLO, a start time).+ function notes(g, el, { annotations = [], reference = null, x, y, padT, h, padB, w, padL }) {+ const ink = css(el, '--axis-ink', '#6b6b6b');+ for (const a of annotations) {+ const xx = x(a.at);+ svg('line', { x1: xx, x2: xx, y1: padT, y2: h - padB, stroke: ink, 'stroke-width': 1, opacity: 0.45, 'shape-rendering': 'crispEdges' }, g);+ if (a.label) { const t = svg('text', { x: xx + 4, y: padT + 10, 'font-size': 11, fill: ink }, g); t.textContent = a.label; }+ }+ for (const r of [].concat(reference || [])) {+ const yy = y(r.value);+ svg('line', { x1: padL, x2: w, y1: yy, y2: yy, stroke: ink, 'stroke-width': 1, 'stroke-dasharray': '4 4', opacity: 0.7 }, g);+ if (r.label) { const t = svg('text', { x: w, y: yy - 5, 'text-anchor': 'end', 'font-size': 11, fill: ink }, g); t.textContent = r.label; }+ }+ }+ function line(el, { labels, series, format = fmt.int, height = 220, fill = false, min, step = false, annotations, reference }) {el._fmt = format;const draw = () => {const { s, w, h } = frame(el, height);- const all = series.flatMap((x) => x.values.filter((v) => v != null));+ const all = series.flatMap((x) => x.values.filter((v) => v != null)).concat([].concat(reference || []).map((r) => r.value));const yt = ticks(min ?? Math.min(0, ...all), Math.max(...all), 4);const padL = 12 + Math.max(...yt.map((v) => String(format(v)).length)) * 7, padB = 26, padT = 8;const x = (i) => padL + (i * (w - padL)) / Math.max(1, labels.length - 1);@@ -67,10 +86,12 @@series.forEach((sr, k) => {const col = sr.colour || (k === 0 ? css(el, '--chart-1', '#2f6fdf') : css(el, `--chart-${k + 1}`, css(el, '--chart-muted', '#a3a3a3')));const pts = sr.values.map((v, i) => (v == null ? null : [x(i), y(v)]));- const d = pts.reduce((acc, p, i) => (p ? acc + (acc && pts[i - 1] ? 'L' : 'M') + p[0].toFixed(1) + ' ' + p[1].toFixed(1) : acc), '');+ // step: a balance that only changes on given days holds its value until the next one+ const d = pts.reduce((acc, p, i) => (p ? acc + (acc && pts[i - 1] ? (step ? `L${p[0].toFixed(1)} ${pts[i - 1][1].toFixed(1)}L` : 'L') : 'M') + p[0].toFixed(1) + ' ' + p[1].toFixed(1) : acc), '');if (fill && k === 0) { const first = pts.find(Boolean), last = [...pts].reverse().find(Boolean); svg('path', { d: `${d}L${last[0]} ${y(yt[0])}L${first[0]} ${y(yt[0])}Z`, fill: col, opacity: 0.12 }, g); }svg('path', { d, fill: 'none', stroke: col, 'stroke-width': 2, 'stroke-linejoin': 'round', 'stroke-linecap': 'round' }, g);});+ notes(g, el, { annotations, reference, x, y, padT, h, padB, w, padL });// hover: a rule, a dot per series and a bare tooltipconst tip = tooltip(el), rule = svg('line', { y1: padT, y2: h - padB, stroke: css(el, '--axis-ink', '#6b6b6b'), 'stroke-width': 1, opacity: 0 }, g);const dots = series.map((sr, k) => svg('circle', { r: 3.5, fill: css(el, '--surface', '#fff'), stroke: sr.colour || css(el, `--chart-${k + 1}`, '#2f6fdf'), 'stroke-width': 2, opacity: 0 }, g));@@ -82,11 +103,11 @@};draw(); watch(el, draw);}- function bars(el, { labels, values, format = fmt.int, height = 200, highlight = null, colour }) {+ function bars(el, { labels, values, format = fmt.int, height = 200, highlight = null, colour, annotations, reference }) {el._fmt = format;const draw = () => {const { s, w, h } = frame(el, height);- const yt = ticks(0, Math.max(...values), 4);+ const yt = ticks(0, Math.max(...values, ...[].concat(reference || []).map((r) => r.value)), 4);const padL = 12 + Math.max(...yt.map((v) => String(format(v)).length)) * 7, padB = 26, padT = 8;const band = (w - padL) / values.length, bw = Math.max(2, band * 0.62);const x = (i) => padL + band * i + band / 2;@@ -95,6 +116,7 @@axes(g, { w, h, padL, padB, padT, yt, y, xLabels: labels, x, el });const main = colour || css(el, '--chart-1', '#2f6fdf'), muted = css(el, '--chart-muted', '#c9c9c9');values.forEach((v, i) => { const r = svg('rect', { x: x(i) - bw / 2, y: y(v), width: bw, height: Math.max(0, y(0) - y(v)), fill: highlight == null || highlight === i ? main : muted, 'shape-rendering': 'crispEdges' }, g); const t = svg('title', {}, r); t.textContent = `${labels[i]}: ${format(v)}`; });+ notes(g, el, { annotations, reference, x, y, padT, h, padB, w, padL });s.setAttribute('aria-label', `${labels.length} bars from ${labels[0]} to ${labels.at(-1)}; highest ${format(Math.max(...values))}`);};draw(); watch(el, draw);@@ -122,6 +144,43 @@}el.appendChild(list);}+ // Planned against spent: the track is the plan, the fill what is spent, a lighter segment what is+ // already committed (bills to come), and an overrun past the track's end in the negative colour.+ // One row per category: label and figures on one line, the 8px track under them.+ function plan(el, rows, { format = fmt.money('EUR', 0), note = (r) => r.spent > r.planned ? `${format(r.spent - r.planned)} over` : `${format(r.planned - r.spent - (r.committed || 0))} left` } = {}) {+ el.innerHTML = '';+ const list = document.createElement('ul'); list.style.cssText = 'list-style:none;margin:0;padding:0;display:grid;gap:14px;font-variant-numeric:tabular-nums';+ const max = Math.max(...rows.map((r) => Math.max(r.planned, r.spent + (r.committed || 0))));+ for (const r of rows) {+ const over = r.spent > r.planned;+ const li = document.createElement('li');+ const top = document.createElement('div'); top.style.cssText = 'display:flex;justify-content:space-between;gap:12px;margin-bottom:6px';+ top.innerHTML = `<span>${r.label}</span><span><b style="font-weight:500">${format(r.spent)}</b> <span style="color:var(--muted,#5f6368)">of ${format(r.planned)} · </span><span style="color:${over ? 'var(--negative,#c4242a)' : 'var(--muted,#5f6368)'}">${note(r)}</span></span>`;+ const track = document.createElement('div'); track.style.cssText = `position:relative;height:8px;border-radius:999px;background:var(--rule,#eceeef);width:${(r.planned / max) * 100}%;overflow:visible`;+ const pct = (v) => (v / r.planned) * 100;+ const spent = Math.min(r.spent, r.planned);+ track.innerHTML = `<span style="position:absolute;inset:0 auto 0 0;width:${pct(spent)}%;border-radius:999px;background:var(--chart-1,#2f6fdf)"></span>`+ + (r.committed ? `<span style="position:absolute;top:0;bottom:0;left:${pct(spent)}%;width:${Math.min(pct(r.committed), 100 - pct(spent))}%;background:var(--chart-1,#2f6fdf);opacity:.35"></span>` : '')+ + (over ? `<span style="position:absolute;top:0;bottom:0;left:100%;width:${pct(r.spent - r.planned)}%;border-radius:0 999px 999px 0;background:var(--negative,#c4242a)"></span>` : '');+ track.setAttribute('role', 'img'); track.setAttribute('aria-label', `${r.label}: ${format(r.spent)} of ${format(r.planned)}${r.committed ? `, ${format(r.committed)} committed` : ''}${over ? ', over plan' : ''}`);+ li.append(top, track); list.appendChild(li);+ }+ el.appendChild(list);+ }+ // Share against a target: one row per part, the current share as a bar and a 1px tick at the target,+ // so drift reads at a glance (never two stacked bars to compare).+ function bullet(el, rows, { format = fmt.pct(1), max = Math.max(...rows.map((r) => Math.max(r.value, r.target))) * 1.15 } = {}) {+ el.innerHTML = '';+ const list = document.createElement('ul'); list.style.cssText = 'list-style:none;margin:0;padding:0;display:grid;gap:12px;font-variant-numeric:tabular-nums';+ for (const r of rows) {+ const drift = r.value - r.target;+ const li = document.createElement('li'); li.style.cssText = 'display:grid;grid-template-columns:minmax(90px,30%) 1fr auto;align-items:center;gap:12px';+ li.innerHTML = `<span>${r.label}</span><span style="position:relative;height:10px;background:var(--rule,#eceeef);border-radius:2px"><span style="position:absolute;inset:0 auto 0 0;width:${(r.value / max) * 100}%;background:var(--chart-1,#2f6fdf);border-radius:2px"></span><span style="position:absolute;top:-4px;bottom:-4px;left:${(r.target / max) * 100}%;width:2px;margin-left:-1px;background:var(--text,#111)"></span></span><span><b style="font-weight:500">${format(r.value)}</b> <span style="color:${Math.abs(drift) >= (r.tolerance ?? 0.02) ? 'var(--negative,#c4242a)' : 'var(--muted,#5f6368)'}">${drift >= 0 ? '+' : '−'}${format(Math.abs(drift))} vs ${format(r.target)}</span></span>`;+ li.setAttribute('aria-label', `${r.label}: ${format(r.value)}, target ${format(r.target)}`);+ list.appendChild(li);+ }+ el.appendChild(list);+ }function watch(el, draw) { if (!('ResizeObserver' in window)) return; let w = el.clientWidth; new ResizeObserver(() => { if (Math.abs(el.clientWidth - w) > 4) { w = el.clientWidth; draw(); } }).observe(el); }- window.Charts = { line, bars, ring, barList, ticks, fmt };+ window.Charts = { line, bars, ring, barList, plan, bullet, ticks, fmt };})();diff --git a/skills/taste-skill/library/app.json b/skills/taste-skill/library/app.jsonindex ebbdd8e..281738b 100644--- a/skills/taste-skill/library/app.json+++ b/skills/taste-skill/library/app.json@@ -7,7 +7,15 @@"name": "Achromatic ledger","theme": "light","basis": "4 screens: a seller home, a per-agent insights page, a generated report, a settings page with usage numbers",- "suits": ["finance", "commerce", "devtools", "support", "report", "workspace", "builder"],+ "suits": [+ "finance",+ "commerce",+ "devtools",+ "support",+ "report",+ "workspace",+ "builder"+ ],"idea": "The chrome holds no colour at all; money and counts are set in ink, and a single hue appears only where a figure changed.","colourBudget": "under 1% coloured pixels; the chart is ink, the only hue is a small change signal","tokens": {@@ -23,20 +31,49 @@"positive": "#2e7d32","negative": "#c4242a","warning": "#92400e",- "chart": ["#141414", "#8a8a8a", "#1d5fbf"],+ "chart": [+ "#141414",+ "#8a8a8a",+ "#1d5fbf"+ ],"pills": {- "positive": ["#dcfae5", "#04250e"],- "negative": ["#ffedea", "#831c1e"],- "warning": ["#fffbeb", "#92400e"],- "neutral": ["#eeeeee", "#3d3d3d"]+ "positive": [+ "#dcfae5",+ "#04250e"+ ],+ "negative": [+ "#ffedea",+ "#831c1e"+ ],+ "warning": [+ "#fffbeb",+ "#92400e"+ ],+ "neutral": [+ "#eeeeee",+ "#3d3d3d"+ ]+ },+ "radius": {+ "card": 12,+ "control": 8},- "radius": { "card": 12, "control": 8 },"font": {"family": "Geist","second": "Geist Mono, for IDs and keys only","fallback": "Inter, system-ui, sans-serif",- "sizes": { "title": 24, "section": 16, "kpi": 30, "body": 14, "small": 12 },- "weights": [400, 500, 700],+ "sizes": {+ "title": 24,+ "section": 16,+ "kpi": 30,+ "body": 14,+ "small": 12+ },+ "weights": [+ 400,+ 500,+ 700+ ],"note": "700 is for money figures only; every other number is 400-500."},"density": "sparse",@@ -47,7 +84,10 @@"controlHeight": 36},"shell": "open-plane",- "shellAlternatives": ["icon-rail", "no-sidebar"],+ "shellAlternatives": [+ "icon-rail",+ "no-sidebar"+ ],"signature": "No brand colour anywhere in the chrome: the primary action is near-black or a grey pill (#e5e5e5), the main series is drawn in ink with the comparison or the part after the cursor in grey, zero balances are set in grey, and the only hue on the screen is a small triangle or a short coloured number where a figure changed.","avoid": ["a brand-coloured primary button",@@ -62,7 +102,15 @@"name": "Framed sheet","theme": "light","basis": "6 screens: a developer platform overview, an analytics overview, an events analytics tab, a list detail, a reports dashboard, a flow builder",- "suits": ["analytics", "devtools", "builder", "smb-admin", "support", "commerce", "report"],+ "suits": [+ "analytics",+ "devtools",+ "builder",+ "smb-admin",+ "support",+ "commerce",+ "report"+ ],"idea": "The app chrome is one tinted L-shaped frame; the work sits on a white sheet with a hairline edge and soft corners, so depth comes from a single tone step and no shadow.","colourBudget": "under 3%; the brand shrinks to the logo and a 2px tab underline, the data carries the chroma","tokens": {@@ -79,21 +127,51 @@"positive": "#1e7b4f","negative": "#c4242a","warning": "#92400e",- "chart": ["#1b6c80", "#2f70bb", "#a86f0c"],+ "chart": [+ "#1b6c80",+ "#2f70bb",+ "#a86f0c"+ ],"pills": {- "positive": ["#dcfae5", "#04250e"],- "negative": ["#ffedea", "#831c1e"],- "warning": ["#fffbeb", "#92400e"],- "neutral": ["#ebedee", "#353736"]+ "positive": [+ "#dcfae5",+ "#04250e"+ ],+ "negative": [+ "#ffedea",+ "#831c1e"+ ],+ "warning": [+ "#fffbeb",+ "#92400e"+ ],+ "neutral": [+ "#ebedee",+ "#353736"+ ]+ },+ "radius": {+ "card": 8,+ "control": 6,+ "sheet": 16},- "radius": { "card": 8, "control": 6, "sheet": 16 },"sheetInset": 8,"font": {"family": "IBM Plex Sans","second": "IBM Plex Mono, for IDs and keys only","fallback": "Inter, system-ui, sans-serif",- "sizes": { "title": 22, "section": 16, "kpi": 28, "body": 14, "small": 12 },- "weights": [400, 500, 600],+ "sizes": {+ "title": 22,+ "section": 16,+ "kpi": 28,+ "body": 14,+ "small": 12+ },+ "weights": [+ 400,+ 500,+ 600+ ],"note": "KPI values at 400; the semibold goes on the label and the active tab."},"density": "medium",@@ -120,7 +198,12 @@"name": "Accent ladder","theme": "light","basis": "3 screens: a newsletter home, a network analytics overview, a cap-table company home",- "suits": ["creator", "smb-admin", "community", "analytics"],+ "suits": [+ "creator",+ "smb-admin",+ "community",+ "analytics"+ ],"idea": "One brand hue at full strength only on small marks, and its pale tints doing all the area work: the active nav row, a plan card, badges and progress tracks.","colourBudget": "3-10%, nearly all of it as pale tints of the one hue","tokens": {@@ -139,21 +222,54 @@"positive": "#247b50","negative": "#c4242a","warning": "#92400e",- "chart": ["#b8336a", "#6b7280", "#d4618f"],+ "chart": [+ "#b8336a",+ "#6b7280",+ "#d4618f"+ ],"pills": {- "positive": ["#dcfce7", "#14532d"],- "negative": ["#ffedea", "#831c1e"],- "warning": ["#fffbeb", "#92400e"],- "neutral": ["#f3f4f6", "#374151"],- "accent": ["#fdf2f7", "#6b1d3e"]+ "positive": [+ "#dcfce7",+ "#14532d"+ ],+ "negative": [+ "#ffedea",+ "#831c1e"+ ],+ "warning": [+ "#fffbeb",+ "#92400e"+ ],+ "neutral": [+ "#f3f4f6",+ "#374151"+ ],+ "accent": [+ "#fdf2f7",+ "#6b1d3e"+ ]+ },+ "radius": {+ "card": 8,+ "control": 6},- "radius": { "card": 8, "control": 6 },"font": {"family": "DM Sans","second": null,"fallback": "Inter, system-ui, sans-serif",- "sizes": { "title": 32, "section": 18, "kpi": 24, "body": 14, "small": 12 },- "weights": [400, 500, 600, 700],+ "sizes": {+ "title": 32,+ "section": 18,+ "kpi": 24,+ "body": 14,+ "small": 12+ },+ "weights": [+ 400,+ 500,+ 600,+ 700+ ],"note": "700 for the page title only."},"density": "sparse",@@ -164,7 +280,9 @@"controlHeight": 32},"shell": "open-plane",- "shellAlternatives": ["ruled-t-frame"],+ "shellAlternatives": [+ "ruled-t-frame"+ ],"signature": "The full hue goes only on small marks: the one filled-button style, the data series and the active nav icon. Its 50-200 tints carry every area: the active nav row (tint fill with the dark ink of the hue), the plan or trial card, badges and progress tracks. The primary action may instead be near-black, as on the study's newsletter home.","avoid": ["the full hue on large areas",@@ -180,7 +298,10 @@"name": "Editorial greeting","theme": "light","basis": "2 screens: a team workspace home and a personal insights home",- "suits": ["workspace", "creator"],+ "suits": [+ "workspace",+ "creator"+ ],"idea": "A personal or team home that opens with a typeset greeting in a centred column; every number below it is set at regular weight on tonal panels.","colourBudget": "under 2% for the accent; tonal panels carry the structure","tokens": {@@ -196,20 +317,49 @@"positive": "#2e7d32","negative": "#1f201d","warning": "#92400e",- "chart": ["#d32420", "#8c8c88"],+ "chart": [+ "#1f201d",+ "#d32420",+ "#8c8c88"+ ],"pills": {- "positive": ["#dcfae5", "#04250e"],- "negative": ["#f3f3f3", "#1f201d"],- "warning": ["#fffbeb", "#92400e"],- "neutral": ["#f3f3f3", "#3d3d3a"]+ "positive": [+ "#dcfae5",+ "#04250e"+ ],+ "negative": [+ "#f3f3f3",+ "#1f201d"+ ],+ "warning": [+ "#fffbeb",+ "#92400e"+ ],+ "neutral": [+ "#f3f3f3",+ "#3d3d3a"+ ]+ },+ "radius": {+ "card": 22,+ "control": 999},- "radius": { "card": 22, "control": 999 },"font": {"family": "Instrument Sans","second": "Instrument Serif, for the greeting only","fallback": "Inter, system-ui, sans-serif",- "sizes": { "title": 48, "section": 14, "kpi": 32, "body": 14, "small": 12 },- "weights": [400, 500, 600],+ "sizes": {+ "title": 48,+ "section": 14,+ "kpi": 32,+ "body": 14,+ "small": 12+ },+ "weights": [+ 400,+ 500,+ 600+ ],"note": "The 48px title is the serif greeting; set in the sans it is 24/400. Every figure is 400."},"density": "sparse",@@ -220,14 +370,18 @@"controlHeight": 38},"shell": "open-plane",- "shellAlternatives": ["framed-sheet"],- "signature": "The greeting is the h1, in a centred 1100px column on a real 12-column grid (77px columns, 16px gutters), with mixed spans that land on column lines (3/3/3/3, then 7/5, then 8/4). Every figure below is regular weight on tonal panels: panel one step off white, value card white inside it.",+ "shellAlternatives": [+ "framed-sheet"+ ],+ "signature": "The greeting is the h1, in a centred 1100px column on a real 12-column grid (77px columns, 16px gutters), with spans that change by row but share column lines (3/3/3/3, then 9/3, then 6/6, so every internal edge meets one above it). Every figure below is set at regular weight on tonal panels, one layer each: a panel one step off white holds its title and its content directly; a white inner card is used once, for the main chart.","avoid": ["an emoji in the greeting","a tracked uppercase date above the greeting (put the date after it or in the grey line below)","a 624-864px column on a desktop screen (both were flagged as wasted width)","an orange-brown accent: keep it a clear red, never terracotta or rust",- "a red falling number: the accent is red here, so a fall is written with a minus sign in ink (negative is set to the ink on purpose)"+ "a red falling number: the accent is red here, so a fall is written with a minus sign in ink (negative is set to the ink on purpose)",+ "a tray around every card (a grey panel with a white card 6px inside it, on every block, read as a bento template in testing)",+ "the red accent on a growth line: in an analytics view red reads as loss, so the series is drawn in ink and the red marks one highlighted point or the latest bar"],"notes": "One studied screen set its greeting in a serif at 48/700 and its counts in a mono; the other set the greeting at 24/400 in the sans. The red is the second screen's chart red moved two degrees of hue out of the house terracotta range."},@@ -236,7 +390,10 @@"name": "Pastel consumer","theme": "light","basis": "2 screens: a wallet home and a personal finance home",- "suits": ["wallet", "finance"],+ "suits": [+ "wallet",+ "finance"+ ],"idea": "Categories are coded by pale tints whose ink is the dark of the same hue, all under one large radius, and each headline sum sits inside the card that explains it.","colourBudget": "5-8%, as pale tiles and data marks","tokens": {@@ -254,21 +411,53 @@"positive": "#2f7a45","negative": "#c41c29","warning": "#92400e",- "chart": ["#1d5fd6", "#2a8798", "#3f8f60"],+ "chart": [+ "#1d5fd6",+ "#2a8798",+ "#3f8f60"+ ],"pills": {- "positive": ["#dcfae5", "#04250e"],- "negative": ["#ffedea", "#831c1e"],- "warning": ["#fffbeb", "#92400e"],- "neutral": ["#eef1f4", "#3a3d40"],- "accent": ["#dcf1ff", "#0a3a80"]+ "positive": [+ "#dcfae5",+ "#04250e"+ ],+ "negative": [+ "#ffedea",+ "#831c1e"+ ],+ "warning": [+ "#fffbeb",+ "#92400e"+ ],+ "neutral": [+ "#eef1f4",+ "#3a3d40"+ ],+ "accent": [+ "#dcf1ff",+ "#0a3a80"+ ]+ },+ "radius": {+ "card": 20,+ "control": 10},- "radius": { "card": 20, "control": 10 },"font": {"family": "Manrope","second": null,"fallback": "Inter, system-ui, sans-serif",- "sizes": { "title": 28, "section": 20, "kpi": 32, "body": 16, "small": 14 },- "weights": [400, 500, 600],+ "sizes": {+ "title": 28,+ "section": 20,+ "kpi": 32,+ "body": 16,+ "small": 14+ },+ "weights": [+ 400,+ 500,+ 600+ ],"note": "Money at 24-32px; card titles regular; semibold for net worth, bill amounts and actions."},"density": "medium",@@ -279,7 +468,9 @@"controlHeight": 40},"shell": "open-plane",- "shellAlternatives": ["icon-rail"],+ "shellAlternatives": [+ "icon-rail"+ ],"signature": "Pale category tiles with the dark of their own hue as ink (#dcf1ff with #0a3a80), one large radius (20px on cards, stepping down to 10, 8 and 5 inside), and quiet money polarity: income green with a plus sign, spending in ink, no red on ordinary outgoings.","avoid": ["a gradient balance card",@@ -295,7 +486,11 @@"name": "True-black flat","theme": "dark","basis": "5 screens: an events back office, an event analytics tab, a community overview, an artist studio home, an artist insights page",- "suits": ["community", "creator", "markets"],+ "suits": [+ "community",+ "creator",+ "markets"+ ],"idea": "Night mode on true black: sidebar, top bar and page share one ground, elevation is a lightness step alone, and colour is confined to data marks.","colourBudget": "at or under 3%; the accent never touches buttons, tabs or nav","tokens": {@@ -312,20 +507,49 @@"positive": "#3fc07a","negative": "#e5484d","warning": "#e5a93b",- "chart": ["#c6f24e", "#e6e6e6", "#6b6b6b"],+ "chart": [+ "#c6f24e",+ "#e6e6e6",+ "#6b6b6b"+ ],"pills": {- "positive": ["#172a1d", "#3fc07a"],- "negative": ["#2c1a20", "#e5566f"],- "warning": ["#2b2414", "#e5a93b"],- "neutral": ["#222222", "#ffffff"]+ "positive": [+ "#172a1d",+ "#3fc07a"+ ],+ "negative": [+ "#2c1a20",+ "#e5566f"+ ],+ "warning": [+ "#2b2414",+ "#e5a93b"+ ],+ "neutral": [+ "#222222",+ "#ffffff"+ ]+ },+ "radius": {+ "card": 20,+ "control": 999},- "radius": { "card": 20, "control": 999 },"font": {"family": "Inter","second": null,"fallback": "system-ui, sans-serif",- "sizes": { "title": 20, "section": 16, "kpi": 24, "body": 14, "small": 12 },- "weights": [400, 500, 600],+ "sizes": {+ "title": 20,+ "section": 16,+ "kpi": 24,+ "body": 14,+ "small": 12+ },+ "weights": [+ 400,+ 500,+ 600+ ],"note": "Nothing above 600; inactive nav labels #bbb, active #fff."},"density": "medium",@@ -336,7 +560,9 @@"controlHeight": 36},"shell": "ruled-t-frame",- "shellAlternatives": ["no-sidebar"],+ "shellAlternatives": [+ "no-sidebar"+ ],"signature": "Elevation by lightness alone (#000 ground, #111 card, #2a2a2a nested panel) with no borders or shadows on cards; the active nav item is marked only by its label going from #bbb to #fff; the primary control is made primary by inversion, a white 36px pill with black text.","avoid": ["a navy or slate dark theme",@@ -352,7 +578,10 @@"name": "Data terminal","theme": "dark","basis": "1 screen: a stock research view. Keep it narrow.",- "suits": ["markets", "devtools"],+ "suits": [+ "markets",+ "devtools"+ ],"idea": "A research or monitoring screen read in long sessions: cards darker than the ground, tabular digits that stack, signs instead of colour, and every selection marked by the same 1px accent line.","colourBudget": "under 3%; the accent is never more than a 1px line","tokens": {@@ -368,21 +597,51 @@"positive": "#44a282","negative": "#e5566f","warning": "#d9a441",- "chart": ["#f2f2f3", "#e5566f", "#4a8ad6"],+ "chart": [+ "#f2f2f3",+ "#e5566f",+ "#4a8ad6"+ ],"pills": {- "positive": ["#1b2828", "#5fc39c"],- "negative": ["#2c1a20", "#e5566f"],- "warning": ["#2a2416", "#d9a441"],- "neutral": ["#212023", "#bdbdc0"]+ "positive": [+ "#1b2828",+ "#5fc39c"+ ],+ "negative": [+ "#2c1a20",+ "#e5566f"+ ],+ "warning": [+ "#2a2416",+ "#d9a441"+ ],+ "neutral": [+ "#212023",+ "#bdbdc0"+ ]},"shadow": "0 12px 28px rgba(0,0,0,.2)",- "radius": { "card": 6, "control": 999 },+ "radius": {+ "card": 6,+ "control": 999+ },"font": {"family": "Public Sans","second": null,"fallback": "Inter, system-ui, sans-serif",- "sizes": { "title": 26, "section": 20, "kpi": 20, "body": 13, "small": 11 },- "weights": [400, 500, 600, 700],+ "sizes": {+ "title": 26,+ "section": 20,+ "kpi": 20,+ "body": 13,+ "small": 12+ },+ "weights": [+ 400,+ 500,+ 600,+ 700+ ],"note": "Section titles 20/400 in the muted grey; card titles 16/600; tabular figures everywhere."},"density": "dense",@@ -396,11 +655,11 @@"shellAlternatives": [],"signature": "Every selection (tab, toggle, range, nav item) is a 1px accent line exactly as wide as its label, placed on the nearest existing edge; numbers stay white or grey and carry their sign in the text ('+$24,000,000').","avoid": [- "green and red on every number","filled pill tabs or a coloured segmented control","a chart with no scale and no dates (the studied screen had none and was flagged)","tertiary text under 4.5:1 (#4c4c4f read at about 2:1 in the study)",- "lighter cards with borders and a glow"+ "lighter cards with borders and a glow",+ "green and red on every number; the one column whose job is \"what moved today\" and a negative headline figure may carry the polarity colours"],"notes": "The studied screen's muted grey #82848a and red #d4405d were lifted to #8a8c92 and #e5566f so text passes 4.5:1 on the card. Its card list rows sit on a 28px pitch and its table rows on 42px."}@@ -410,7 +669,13 @@"id": "open-plane","name": "Open plane","basis": "5 of 23 screens",- "suits": ["finance", "wallet", "workspace", "creator", "analytics"],+ "suits": [+ "finance",+ "wallet",+ "workspace",+ "creator",+ "analytics"+ ],"numbers": {"sidebarWidth": "230-256 (230, 240, 256 in the study; 280 and 292 with a built-in icon rail)","separation": "none, or one 1px hairline; the sidebar sits on the page ground or within 1-2% of it",@@ -429,7 +694,13 @@"id": "framed-sheet","name": "Tinted frame, white sheet","basis": "8 of 23 screens, in three variants",- "suits": ["analytics", "devtools", "builder", "smb-admin", "support"],+ "suits": [+ "analytics",+ "devtools",+ "builder",+ "smb-admin",+ "support"+ ],"numbers": {"chrome": "#f6f6f6-#f9fbfc (a warm #f7f6f2 once)","sheetInset": "8px from the window's right and bottom edges (12 and 16 once each)",@@ -447,7 +718,11 @@"id": "ruled-t-frame","name": "Ruled T-frame","basis": "4 of 23 screens (3 dark, 1 light)",- "suits": ["community", "creator", "smb-admin"],+ "suits": [+ "community",+ "creator",+ "smb-admin"+ ],"numbers": {"sidebarWidth": "210-240","topBar": "64px with a 1px bottom rule",@@ -463,7 +738,12 @@"id": "icon-rail","name": "Icon rail","basis": "3 of 23 screens",- "suits": ["markets", "devtools", "finance", "wallet"],+ "suits": [+ "markets",+ "devtools",+ "finance",+ "wallet"+ ],"numbers": {"railWidth": "50-60, median 55","icon": "15-18px outline",@@ -479,7 +759,11 @@"id": "no-sidebar","name": "No sidebar","basis": "3 of 23 screens",- "suits": ["report", "creator", "community"],+ "suits": [+ "report",+ "creator",+ "community"+ ],"numbers": {"topBar": "46-48px on the page ground, no border","column": "centred, 1088-1208px",@@ -496,7 +780,12 @@"id": "kpi-strip-chart-rail","name": "KPI strip, main chart and a side rail","screen": "overview",- "kinds": ["creator", "smb-admin", "community", "analytics"],+ "kinds": [+ "creator",+ "smb-admin",+ "community",+ "analytics"+ ],"basis": "a newsletter home; a community overview","blueprint": "Title row: a 24px noun or the product's name at 600-700, an optional 14-16px grey line under it, and the one primary action on the right, bottom-aligned with that line. 16-24px below, the scope row: section tabs and the date range in one row of 32-36px controls, or a 48px segmented track with the range select inside its right end. Then a grid of 1fr and a fixed 384px rail with a 24px gap. Main column: one KPI container split by 1px dividers into 3-5 equal cells (14px grey label, 24px value at 400-600, a 12px caption naming the baseline and window), then the main chart card, which is the largest thing on the screen, then the next card, all 16px apart. Rail: 16px headings outside their cards, 8px above each and 16px after the previous card; a recent-items list of 3-5 rows on a 45px pitch with 1px rules, closed by a 30px outlined 'View all' button instead of pagination. The rail starts level with the first card, not with the title.","phone": "The rail moves below the main column; the KPI container becomes a 2-column grid; tabs scroll inside their own row."@@ -505,16 +794,23 @@"id": "kpi-tabs-chart","name": "KPIs as the chart's tabs","screen": "overview",- "kinds": ["finance", "commerce"],+ "kinds": [+ "finance",+ "commerce"+ ],"basis": "a seller home",- "blueprint": "One card per subject, stacked full width 8-16px apart, the page header indented by the card padding so the title, the card titles, the numbers and the plot share one left edge. Balances that do not change during the day go first, in one container split by 1px dividers into equal columns; a zero balance is grey and its caption becomes the next step. In the main card, 2-4 KPIs sit in a row and act as the chart's series tabs: the selected one in ink, the others grey with their label and value; choosing one swaps the series. Under them, one line chart as wide as the card's content (about 1136x220 in the study): 3-4 solid 1px gridlines, 4-6 round y ticks at 12px, a 2-3px line in ink with straight segments and no fill, an 8px hover dot with a 1px dashed guide and the line after the cursor in pale grey. Close with a 2-3 row comparison table on a 36px pitch, value and change columns right-aligned under a 14px grey header such as 'vs prior Monday'.",+ "blueprint": "One card per subject, 8-16px apart: the main chart card runs full width, and any card holding a table of five columns or fewer, or a short list, pairs with its neighbour in two columns, the page header indented by the card padding so the title, the card titles, the numbers and the plot share one left edge. Balances that do not change during the day go first, in one container split by 1px dividers into equal columns; a zero balance is grey and its caption becomes the next step. In the main card, 2-4 KPIs sit in a row and act as the chart's series tabs: the selected one in ink, the others grey with their label and value; choosing one swaps the series. Under them, one line chart as wide as the card's content (about 1136x220 in the study): 3-4 solid 1px gridlines, 4-6 round y ticks at 12px, a 2-3px line in ink with straight segments and no fill, an 8px hover dot with a 1px dashed guide and the line after the cursor in pale grey. Close with a 2-3 row comparison table on a 36px pitch, value and change columns right-aligned under a 14px grey header such as 'vs prior Monday'.","phone": "KPI tabs become a 2-up row above the chart; the chart is full width, 160-200px tall, with 4 x labels; the comparison table keeps its two right-aligned columns."},{"id": "chart-pairs","name": "Per-period and running-total pairs","screen": "analytics",- "kinds": ["community", "smb-admin", "analytics"],+ "kinds": [+ "community",+ "smb-admin",+ "analytics"+ ],"basis": "a network analytics overview","blueprint": "Title at 24-32px with one sentence under it saying what the filters do, then one filter row of 36-38px controls (one filled or near-black, the rest borderless or text, a reset link last) and 16-24px to the KPIs. KPI row: 3 equal cards in the content column (3 x 372 + 2 x 17 = 1152 in the study) or one divided container; a 16px label over the value with the change written as a phrase on the value's baseline ('+8 in the last 90 days'), grey when it is zero. Then one row per metric: the per-period column chart on the left and its cumulative line on the right, at equal width (2 x 568 + 16 = 1152) and with the same x ticks; square bars, a 2px straight line, integer ticks from zero, no legend because each chart has one series. One gap value horizontally and vertically.","phone": "Pairs stack, the cumulative chart directly under its per-period chart; KPI cards become a single column of label-value rows."@@ -523,7 +819,11 @@"id": "insights-share-tables","name": "Insights with share tables","screen": "analytics",- "kinds": ["analytics", "devtools", "builder"],+ "kinds": [+ "analytics",+ "devtools",+ "builder"+ ],"basis": "a per-agent insights page","blueprint": "No cards: sections are carried by whitespace and a 16/500 heading with one 14px grey sentence under it saying what the section shows. A row of up to 6 KPIs on a fixed pitch (12px grey label over a 30px tabular value, no boxes, no dividers), then one full-width time chart (about 218px plot, 5 hairline gridlines, 11-12px grey ticks, a dot legend under the title, a 'Compare to previous period' text button on the right). Then a 2 x 2 grid of small tables with a 24px gutter whose rows align across the two columns. Each table: a header of 12px grey labels with no fill and no rule, 44px rows with 2px gaps whose rounded fill (#f5f7f9, radius 8) is the data bar, its width the row's share divided by the largest share; Share in 12px grey and Count in 14px ink, both right-aligned. An empty table keeps its header and shows one dashed 1px box about 38px tall with one sentence ('No Slack channel usage in this range.').","phone": "KPIs become a 2 x 3 grid; the chart is full width; the share tables stack in one column and keep their row bars."@@ -532,7 +832,13 @@"id": "table-filter-bar","name": "Table with tabs and a filter bar","screen": "list",- "kinds": ["community", "devtools", "commerce", "support", "smb-admin"],+ "kinds": [+ "community",+ "devtools",+ "commerce",+ "support",+ "smb-admin"+ ],"basis": "an events back office, a tracks studio, a sessions overview","blueprint": "Title row: an 18-24px title on the left, at most an outlined secondary and the one primary (36px) on the right. Underline tabs for the list's states on a full-width 1px rule with a 2px indicator as wide as the label; 22-32px below, the toolbar: a search of about 252-316 x 32-36 on the left, the count ('7 events') and the sort on the right. The table sits on the panel or page ground with no card around it: a header of 12-13px grey sentence-case labels with no fill and no rule, rows on a 48-56px pitch for one line or 72-92px with a thumbnail (media height plus 24-32px), 1px rules 3-7% darker than the ground or no rules at all, the identity column given the most width, numbers right-aligned in tabular figures with the unit muted ('5 /10'), one status mark per row and one kebab at the far right. Drop a column that is empty in every row (a blank co-host column left a 300px dead band). On an overview, cap the rows and link to the full list; on the full list, state the total and load more at the end.","phone": "Rows become two-line items: identity and the key number on line 1, the secondary fields in 13px grey on line 2, the kebab at the right. Tabs scroll in their own row; the search becomes a full-width field."@@ -541,7 +847,11 @@"id": "count-cards-filter","name": "Count cards that filter","screen": "list",- "kinds": ["community", "commerce", "support"],+ "kinds": [+ "community",+ "commerce",+ "support"+ ],"basis": "an events back office","blueprint": "Above a list, 3-5 equal count cards (61px tall, 12px padding, a 13px grey label over a 16/600 value, 8px gap) are the type filter: the selected card gets a 1.5px accent border and a pale accent fill, and the list below shows that type only. Zero counts print as '0' in the same style; no deltas, no icons. This is one place where a row of identical small cards is right: the cards are peers and each one does work.","phone": "The count cards become a horizontally scrolling row of chips with the count inside each, or a select above the list."@@ -550,7 +860,21 @@"id": "settings-two-column","name": "Settings in two columns","screen": "settings",- "kinds": ["devtools", "smb-admin", "support", "workspace", "commerce", "analytics", "finance", "wallet", "creator", "community", "builder", "markets", "report"],+ "kinds": [+ "devtools",+ "smb-admin",+ "support",+ "workspace",+ "commerce",+ "analytics",+ "finance",+ "wallet",+ "creator",+ "community",+ "builder",+ "markets",+ "report"+ ],"basis": "one settings page; stacking from a narrow rail card. The basis is thin.","blueprint": "A centred column of about 1152px. Each section is one row: a label column of about 450px (16/500 title, 14px grey description; the title's cap top 6-8px below the panel top, level with the panel's first line) beside a panel of about 700px with a #fafafa fill, 16px radius, 16px padding, no border and no shadow. Sections are split by a full-width 1px rule with 32px above and below. Inside a panel: field labels 14/500 above 40px white inputs (1px #e8e8e8, radius 10), 8px from label to field, 16px between fields, 24px from the description to the first label, 16px to the Save button; switch rows with a 14/500 title, a 20px status badge 8px after it, a 14px grey description and a 28x16 toggle 16px from the right edge, centred on the title line. A plan-gated feature shows a 48px tinted strip with a 32px button directly above its panel, and the panel stays readable. When a panel runs much taller than its label, put the section's help or a summary of the current values in the label column rather than 250px of nothing.","phone": "Each section stacks: title and description, then the panel at full width. Inside, label, 8-10px, field, 16-26px to the next pair; toggles stay on the right of their title."@@ -559,16 +883,23 @@"id": "settings-with-usage","name": "Settings with usage on top","screen": "settings",- "kinds": ["devtools", "smb-admin", "support"],+ "kinds": [+ "devtools",+ "smb-admin",+ "support"+ ],"basis": "one settings page",- "blueprint": "When a settings screen also reports usage, put 3-4 usage numbers in one row on top (a 14px grey label, a 30px regular value, a 12px change pinned to the card bottom with its window in words, a grey dash where there is no comparison) and link out to the analytics screen ('View more') instead of drawing a chart. Below, the two-column settings rows. One dark primary per screen. Keep upsell to one surface: the studied settings page carried three nags (a top banner, a setup button and a gated strip) and was flagged for it.",+ "blueprint": "Use this only when usage is the question of the view (a plan, billing or quota view), and show only numbers no section below repeats, at a size below the h1. When a settings screen also reports usage, put 3-4 usage numbers in one row on top (a 14px grey label, a 30px regular value, a 12px change pinned to the card bottom with its window in words, a grey dash where there is no comparison) and link out to the analytics screen ('View more') instead of drawing a chart. Below, the two-column settings rows. One dark primary per screen. Keep upsell to one surface: the studied settings page carried three nags (a top banner, a setup button and a gated strip) and was flagged for it.","phone": "The usage row becomes a 2-column grid of label-value pairs; settings rows stack."},{"id": "wallet-balance-actions-assets","name": "Balance, actions and assets","screen": "wallet",- "kinds": ["wallet", "finance"],+ "kinds": [+ "wallet",+ "finance"+ ],"basis": "a wallet home","blueprint": "One column whose every element snaps to its two edges. A balance card (1px border, 16px radius, about 134px tall) holding one 32px figure and one line under it in which only the change is coloured ('-$0.09 in the last 30 days'); the title says what the figure is, so it needs no label. 32px below, 4 equal action tiles in a pale tint with dark same-hue icon and 12-14px label (4 x 144 + 3 x 16 = 624 in the study; scale the column and keep the arithmetic). 32-40px below, text tabs for the asset kinds on a 1px rule with a 2px ink indicator as wide as the word, a network or account select on the right of the same row. Then the asset table: 72px rows (48px round icon plus 24px), no dividers, two-line cells pairing a 16px value with a 14px grey unit amount, numeric columns right-aligned to shared edges, change as a small solid triangle and a coloured percentage, zero change grey, a missing share a grey em dash. On a desktop do not leave the column at phone width: the study's 624px column was flagged as a stretched phone screen; widen it to 864-1100 or give it a second column.","phone": "This pattern is phone-first: the same column at full width with 16px margins, the 4 tiles in one row, the table as two-line rows with the value right-aligned."@@ -577,7 +908,10 @@"id": "finance-home-pinned-rail","name": "Finance home with a pinned accounts column","screen": "overview",- "kinds": ["finance", "wallet"],+ "kinds": [+ "finance",+ "wallet"+ ],"basis": "a personal finance home","blueprint": "No page header and no KPI strip: cards start 36px from the top and each headline sum sits in the card that explains it. On the left, a 306px accounts card pinned at the viewport height minus the 36px margins opens with net worth (16/600 label left, value right) and holds the account tree with no dividers: groups 16px ink, categories 14px ink, leaves 14px grey indented 8px, values right-aligned, a 30px pitch and about 45px between groups; an empty group is a bordered box with an '+ Add account' link instead of $0.00. On the right, a 2-column grid with 24px gaps of cards that answer this month's questions, each with its own period caption: the plan (spanning both columns; a ring with an empty hole, a dot legend, the available figure beside it with a per-day line), recent spending as 61px two-line rows (payee over category, amount over date, right-aligned) and upcoming bills. Income is green with a plus sign; spending stays in ink.","phone": "Net worth becomes the first card; the account tree collapses to its groups with totals; the month cards stack."@@ -586,7 +920,9 @@"id": "builder-canvas","name": "Builder canvas","screen": "builder",- "kinds": ["builder"],+ "kinds": [+ "builder"+ ],"basis": "a flow builder in analytics mode","blueprint": "No global navigation: a 44px top bar on the window ground with no rule (an exit arrow, the object's name at 16/600 with a status pill, and on the right 16px icon buttons on a 40px pitch, a secondary and a near-black primary, split by 1px dividers). Below, two panels on the ground with 8px outer margins and a 12px gap, both with a 1px border, 16px radius and no shadow: a 232px palette (16px padding, groups under 14px labels, items on a 40px pitch with a small type tile, a label and a drag grip) and the canvas, a flat well one step darker than the ground (#f4f6f8 on #f9fbfc) with no dot grid. Nodes share one width (338px in the study), 12px radius, a 1px hairline, padding 16 on top and 12 at the sides, a type tile and a 16/600 title, and their metrics in a well as key-value rows on a 32px pitch with right-aligned tabular or mono values ('0% (0)'). Nodes stack on one spine 64px apart with a 38px round insert button centred in each gap; connectors are 1px orthogonal lines with 6px rounded elbows. Overlays (date range, zoom, minimap) are small white controls pinned 16px inside the canvas corners. Canvas content is one size larger than the chrome (16 against 14). Node-type tiles may be tinted, one pastel per type, the same in the palette and on the canvas: pass --allow icon-chips to the inspector and say why.","phone": "Editing a graph on a phone is rarely the job: show the flow read-only as a vertical list of nodes with their metrics, and the palette as a bottom sheet if editing is kept."@@ -595,25 +931,35 @@"id": "inbox-triage","name": "Inbox triage","screen": "inbox",- "kinds": ["support", "workspace"],+ "kinds": [+ "support",+ "workspace"+ ],"basis": "assembled from the study's list, feed and rail measurements; no inbox screen was in the study",- "blueprint": "Three regions on one ground: the navigation (a 230px sidebar or a 55px rail), the list, and the open item with its details. The list column has a fixed width (the study's fixed columns are 306 and 384px) and its own toolbar: saved views as underline tabs or a select, a 32px search, the count. Rows are two-line, 64-80px: line 1 is who (14/600) with the time in words right-aligned in grey ('9 min', 'Yesterday'); line 2 is the subject or last message in 13-14px grey, truncated to one line with an ellipsis. Unread rows set the name in ink and add a 6px dot or a 16px count circle; read rows set it in the secondary grey. One status mark per row (priority or SLA, as a pale pill or words, not both). The selected row gets a 1px outline at 6px radius, or a darker border with a 1px ring, never a saturated fill. The open item fills the remaining width; its details (customer, plan, history) sit in a fixed column of 306-384px as key-value rows on a 28-32px pitch.",+ "blueprint": "Three regions on one ground: the navigation (a 230px sidebar or a 55px rail), the list, and the open item with its details. The list column has a fixed width (the study's fixed columns are 306 and 384px) and its own toolbar: saved views as underline tabs or a select, a 32px search, the count. Rows are two-line, 64-80px: line 1 is who (14/600) with the time in words right-aligned in grey ('9 min', 'Yesterday'); line 2 is the subject or last message in 13-14px grey, truncated to one line with an ellipsis. Unread rows set the name at 600 and add a 6px dot or a 16px count circle; read rows keep the name and subject in ink at 400 (grey is for meta only, never for a row's identity: faded urgent rows were the top complaint in testing). One status mark per row (priority or SLA, as a pale pill or words, not both). The selected row takes the --active fill of the nav pill (optionally a 2px accent bar inside its left edge), so it is never confused with a hover or a focus ring; never a saturated fill. The row's meta sits in fixed right-aligned slots (assignee 20px, channel 14px, priority 14px) so it lines up as columns; priority is printed only above normal. The open item fills the remaining width; its details (customer, plan, history) sit in a fixed column of 306-384px as key-value rows on a 28-32px pitch.","phone": "One region at a time: the list fills the screen; choosing a row pushes the conversation; the details open from a button in its header; back returns to the list at the same scroll position."},{"id": "workspace-home-greeting","name": "Workspace home with a greeting","screen": "home",- "kinds": ["workspace", "creator"],+ "kinds": [+ "workspace",+ "creator"+ ],"basis": "a team workspace home; a personal insights home",- "blueprint": "A centred column on a real 12-column grid (77px columns, 16px gutters, 1100px), about 72px from the top. The greeting is the h1 (48/700 in a serif, or 24/400 in the sans), with the date after it or in a grey line under it, never as a tracked eyebrow, and no emoji. 50px below, 4 count tiles spanning 3 columns each (128px tall, 16px padding): label, value at regular weight in tabular or mono figures, a plain caption ('Ready when you are'), no deltas. Then mixed spans landing on column lines (7 + 5, then 8 + 4) for the main objects: panels with 20px padding, a 14/600 title, a count chip and a 'View all' link, holding row cards 63px tall with 8px gaps, one step lighter than the panel with a border one step darker. Pale tints may code the panels, each in the hue of the tile that counts it. Only a floating composer, if there is one, carries a shadow, and it must not cover the last rows.",+ "blueprint": "A centred column on a real 12-column grid (77px columns, 16px gutters, 1100px), about 72px from the top. The greeting is the h1 (48/700 in a serif, or 24/400 in the sans), with the date after it or in a grey line under it, never as a tracked eyebrow, and no emoji. 50px below, 4 count tiles spanning 3 columns each (128px tall, 16px padding): label, value at regular weight in tabular or mono figures, a plain caption ('Ready when you are'), no deltas. Then spans that change by row but share column lines (9 + 3, then 6 + 6, so each internal edge meets one above it) for the main objects: panels with 20px padding, a 14/600 title, a count chip and a 'View all' link, holding row cards 63px tall with 8px gaps, one step lighter than the panel with a border one step darker. Pale tints may code the panels, each in the hue of the tile that counts it. Only a floating composer, if there is one, carries a shadow, and it must not cover the last rows.","phone": "Greeting at 24-28px; tiles in a 2 x 2 grid; panels stack in reading order."},{"id": "object-detail-header-grid","name": "Object header and a six-column grid","screen": "detail",- "kinds": ["community", "commerce", "analytics"],+ "kinds": [+ "community",+ "commerce",+ "analytics"+ ],"basis": "an event's analytics tab","blueprint": "The page header is the object itself: one card (88px, 14px padding) holding a 50x62 cover, the 18/600 name with 28px icon buttons beside it (open, copy, share), a 13px grey meta line (date, time, place) and outlined 36px actions on the right. Under it, underline tabs on a full-width 1px rule, then a 36px row with a segmented time range on the left and a refresh button on the right. The body is one 6-column grid with one gutter (14px) in both directions whose spans change by row while every edge lands on the same lines: 3 KPI tiles of 2 columns, the main chart in 4 columns beside a side chart in 2, two progress cards of 3, a full-width trend of 6. Give the widest card to the screen's question, and do not give 824px to one ring and one legend row (flagged).","phone": "The header card keeps cover, name and meta, with actions in a kebab; every grid item takes the full width in the same order."@@ -622,7 +968,10 @@"id": "generated-report","name": "Generated report","screen": "report",- "kinds": ["report", "analytics"],+ "kinds": [+ "report",+ "analytics"+ ],"basis": "a report generated from a CSV","blueprint": "No sidebar; the only chrome is a 47-48px viewer bar with a 1px rule. A centred 1088px column 33px below it: a 24/600 title, a 12px grey line 4px under it naming the source and the load time, one outlined 30px action on the right ('Refresh view'). If the data is a snapshot, one quiet notice (#fffbeb fill, 1px #fde68a, 12px #92400e text, 34px tall). Then 4 stat cards with a 12px gap (4 x 263 + 3 x 12 = 1088), a 12px grey label over an 18/600 tabular value; put the date range in the subtitle, not in a lone fifth card. Two charts side by side at the same 12px gap so their edges meet the stat columns: a time chart on a real time axis with flat labels, and a histogram with equal bins and square bottoms. Then the records table in a card: a 256x30 search in its header, a 14/600 grey header row over a 1px #e5e7eb rule, 37px rows over lighter #f3f4f6 rules, numbers right-aligned, a sort glyph on the active column only.","phone": "Stats in a 2 x 2 grid; charts stacked; the table as two-line rows, or scrolling inside its own frame with the first column fixed."@@ -631,7 +980,12 @@"id": "tabbed-object-detail","name": "Tabbed object detail in a sheet","screen": "detail",- "kinds": ["analytics", "smb-admin", "builder", "support"],+ "kinds": [+ "analytics",+ "smb-admin",+ "builder",+ "support"+ ],"basis": "a list's engagement tab; a reports dashboard","blueprint": "Inside the sheet: a breadcrumb row at 16/600 (the parent in grey, the current page as the h1, a 24px grey type chip after it) with its actions on the right (a text button and an outlined 32px dropdown). Under it, the object's tabs at 14px with a 2px ink underline that runs 8px past the label, on a 1px rule that spans the sheet. 30px below, the filter row: a label above a 300x32 select on the left; the freshness stamp ('Last updated July 21, 2026') and a 40px refresh button on the right, centred on the select's line. Then 3 KPI cards (value 36/400, its label at 16/600 under it, the period in words) and 2 chart cards, all on one 24px gutter so the rows share column lines. Do not stretch a short card to its neighbour's height (it left 250px of dead white) and do not list legend series that have no data.","phone": "Breadcrumb shortens to a back link and the h1; tabs scroll; KPI cards stack as label-value rows; charts full width."@@ -640,7 +994,10 @@"id": "report-card-legend-table","name": "Report card with a legend table","screen": "analytics",- "kinds": ["analytics", "smb-admin"],+ "kinds": [+ "analytics",+ "smb-admin"+ ],"basis": "a campaign overview","blueprint": "A report card (20/600 title, a kebab top right, a 32px select for the scope) whose body splits into a 390px left block and the chart. Left: the hero number at 24/400 with its label under it and one change pill with its window ('vs. previous period'), then the legend as a mini table of 2-4 metric rows on a 57px pitch: dot, name at 15/600, a benchmark pill, the value right-aligned, the change right-aligned. Right: the line chart with 4 gridlines at round values, a 2px baseline with ticks, y labels on the right and axis text no larger than the data (12-14px; 16px ticks were flagged as louder than the numbers). Under it, a detail table whose rate cells stack the count over a 12px grey percentage on one right edge. Use the same colour for a series in the legend dot and in the line.","phone": "The legend table goes above the chart; the detail table becomes two-line rows."@@ -649,7 +1006,10 @@"id": "research-lists-table","name": "Research lists and a long table","screen": "analytics",- "kinds": ["markets", "devtools"],+ "kinds": [+ "markets",+ "devtools"+ ],"basis": "a stock research view","blueprint": "Header: a 26/700 title over a 20px grey date, quiet pill buttons on the right; a 1px rule about 44px below, with the tabs just under it and the active tab marked by a 1px accent line as wide as its label lying on that rule. 64px below, a 2-column row of cards at about 43/57 with a 24px gap: a ranked list on a 28px pitch (16px logo, bold ticker, grey name truncated, a right-aligned grey percentage and a white value, signs in the text) and a chart card with its legend in the header (5px dots, 13px grey labels), a text range selector under the baseline (1M 3M 6M YTD All, the active one marked by the same 1px accent segment) and 'Updated daily' in 11-12px grey. Then a 20/400 grey section title and a full-width table: a 38px header of 11-12px grey labels, 42px rows over 1px rules, ISO dates and every figure right-aligned in tabular numerals, white only for the identity and the total. Give the chart a y-scale and dates (the studied chart had neither and was flagged).","phone": "Cards stack; the range selector stays as text under the chart; the table becomes two-line rows with the total on the right."@@ -658,34 +1018,195 @@"id": "platform-overview-tray","name": "Platform overview with a usage tray","screen": "overview",- "kinds": ["devtools", "analytics"],+ "kinds": [+ "devtools",+ "analytics"+ ],"basis": "a developer platform project overview",- "blueprint": "Sections stacked in one column about 48px apart, each with an 18/500 title on the left and a quiet action on the right ('View all', an outlined Refresh, a date-range button), and freshness in 14px grey after the title with a small status dot. First, a getting-started strip: one container split by 1px dividers into 4 equal cells (16/500 title, a 14px description, a grey arrow top right), shown until setup is done. Then the recent items table, capped at 4-5 rows on a 49px pitch: IDs in mono truncated to 8 characters plus an ellipsis with a copy icon, relative expiry in grey, rules that bleed 8px past the text column. Then usage: a #fafafa tray with 6px padding holding a KPI strip of 5 equal cells (a 14/500 label over a 24/400 value with a 14px unit suffix, '5 mins') and, 6px below, a chart card with a segmented control that switches the metric instead of drawing two series. Durations and timestamps in tabular figures. A missing value is a grey dash at label size, not '--' at value size.",+ "blueprint": "Sections stacked in one column about 48px apart, each with an 18/500 title on the left and a quiet action on the right ('View all', an outlined Refresh, a date-range button), and freshness in 14px grey after the title with a small status dot. First, a getting-started strip: one container split by 1px dividers into 4 equal cells (16/500 title, a 14px description, a grey arrow top right), shown until setup is done. Then the recent items table, capped at 4-5 rows on a 49px pitch: IDs in mono truncated to 8 characters plus an ellipsis with a copy icon, relative expiry in grey, rules that bleed 8px past the text column. Then usage: a #fafafa tray with 6px padding holding a KPI strip of 5 equal cells (a 14/500 label over a 24/400 value with a 14px unit suffix, '5 mins') and, 6px below, a chart card whose metric is chosen by the KPI cells themselves (the selected cell marked by a 2px rule or the active fill), never a second control repeating the KPI labels; the chart takes two-thirds of the width when its line is flat for most of the window, with the next answer beside it. Durations and timestamps in tabular figures. A missing value is a grey dash at label size, not '--' at value size.","phone": "The getting-started strip becomes a 2 x 2 grid or a list; the table becomes two-line rows; the KPI strip a 2-column grid."},{"id": "bar-list-ranking","name": "Bar list and ranking","screen": "analytics",- "kinds": ["analytics", "smb-admin"],+ "kinds": [+ "analytics",+ "smb-admin"+ ],"basis": "an AI-search visibility overview","blueprint": "A 24/700 title with one factual stat chip beside the actions on the right; underline tabs on a 1px rule; a filter row of compound outlined groups that read as a sentence ('Date | Jun 14 - Jul 13 | Daily', 'Region | United States'), 28px tall and 8px apart. KPIs: as many equal columns as there are KPIs (four across, not four in a three-column grid that orphans one), tabular or mono values with fixed decimals. Then two equal panels, each with a 73px header (14/600 title, a 13px grey description, a dropdown that switches the panel's metric) over a full-bleed 1px rule: a sorted bar list (rows on a 64px pitch, a label line, then a 10px pill bar in one colour with no track, the value 5px after the bar's end, the longest bar about 88% of the width) and a ranking table (53px rows, rules inset to the padding, a rank, a 16px logo, a soft chip on the user's own row, values right-aligned). Do not fix a panel's height so its last row is cut off (flagged).","phone": "KPIs in a 2 x 2 grid; panels stack; the bar list keeps its bars at full width."+ },+ {+ "id": "deploy-health-lead",+ "name": "Current deploy and health lead",+ "screen": "overview",+ "kinds": [+ "devtools"+ ],+ "basis": "house pattern from testing: built after a flat 24-hour chart filled a whole first screen and lost to a richer layout",+ "blueprint": "Title row: the project's name as the h1 with a status pill (Healthy, Degraded) and a breadcrumb of team and product above it; repository, branch and a freshness stamp in a 14px grey line under it; the one primary action (Redeploy, or View logs when the latest deploy failed) on the right. Then a full-width card for what is live now: the production deployment's commit message at 16/600, its branch, short SHA in mono, author and age on the left, and three or four facts in divided cells on the right (domain, live since, build time, regions). Then the health strip: three or four KPIs in one divided container, each with its change in words and in the polarity colour when it moved the wrong way. Then a two-column row: the 24-hour chart at two-thirds (deploy markers as 1px ticks with their short SHA, the budget or SLO as a dashed reference line) and, at one-third, the block that explains the worst number (the spike and what reverted it, the status codes behind the error rate). Then the deployments table capped at 6 rows, a failed row carrying its failing step and a View logs action, a building row its elapsed time.",+ "phone": "The live deployment card becomes a stack of label-value rows; the KPIs a 2x2 grid; the chart full width with its markers; the explanation under it; deployments as two-line rows with region and duration on line 2."}],"kinds": {- "finance": { "note": "money homes, budgeting, accounting, seller balances", "styles": ["achromatic-ledger", "pastel-consumer"], "screens": ["overview", "list", "settings"] },- "wallet": { "note": "consumer wallets, crypto, personal finance on the go", "styles": ["pastel-consumer", "achromatic-ledger"], "screens": ["wallet", "list", "settings"] },- "commerce": { "note": "seller and shop back offices: orders, payouts, products", "styles": ["achromatic-ledger", "framed-sheet"], "screens": ["overview", "list", "detail"] },- "analytics": { "note": "B2B analytics, marketing and growth reporting", "styles": ["framed-sheet", "achromatic-ledger", "accent-ladder"], "screens": ["analytics", "list", "detail"] },- "devtools": { "note": "developer platforms: deploys, sessions, API keys, usage", "styles": ["framed-sheet", "data-terminal", "achromatic-ledger"], "screens": ["overview", "list", "settings"] },- "builder": { "note": "flow, form, page and automation builders", "styles": ["framed-sheet", "achromatic-ledger"], "screens": ["builder", "list", "settings"] },- "creator": { "note": "newsletters, creator studios, audience insights", "styles": ["accent-ladder", "editorial-greeting", "true-black-flat"], "screens": ["overview", "analytics", "list"] },- "smb-admin": { "note": "small-business and SaaS admin with plans, onboarding and growth nudges", "styles": ["accent-ladder", "framed-sheet"], "screens": ["overview", "list", "settings"] },- "workspace": { "note": "team hubs and personal homes", "styles": ["editorial-greeting", "achromatic-ledger"], "screens": ["home", "inbox", "settings"] },- "community": { "note": "community, events and media back offices", "styles": ["true-black-flat", "accent-ladder"], "screens": ["overview", "list", "detail"] },- "support": { "note": "support inboxes, queues, helpdesks", "styles": ["achromatic-ledger", "framed-sheet"], "screens": ["inbox", "list", "settings"] },- "markets": { "note": "trading, research and monitoring read in long sessions", "styles": ["data-terminal", "true-black-flat"], "screens": ["analytics", "list", "detail"] },- "report": { "note": "generated or exported reports with no app around them", "styles": ["achromatic-ledger", "framed-sheet"], "screens": ["report"] }+ "finance": {+ "note": "money homes, budgeting, accounting, seller balances",+ "styles": [+ "achromatic-ledger",+ "pastel-consumer"+ ],+ "screens": [+ "overview",+ "list",+ "settings"+ ]+ },+ "wallet": {+ "note": "consumer wallets, crypto, personal finance on the go",+ "styles": [+ "pastel-consumer",+ "achromatic-ledger"+ ],+ "screens": [+ "wallet",+ "list",+ "settings"+ ]+ },+ "commerce": {+ "note": "seller and shop back offices: orders, payouts, products",+ "styles": [+ "achromatic-ledger",+ "framed-sheet"+ ],+ "screens": [+ "overview",+ "list",+ "detail"+ ]+ },+ "analytics": {+ "note": "B2B analytics, marketing and growth reporting",+ "styles": [+ "framed-sheet",+ "achromatic-ledger",+ "accent-ladder"+ ],+ "screens": [+ "analytics",+ "list",+ "detail"+ ]+ },+ "devtools": {+ "note": "developer platforms: deploys, sessions, API keys, usage",+ "styles": [+ "framed-sheet",+ "data-terminal",+ "achromatic-ledger"+ ],+ "screens": [+ "overview",+ "list",+ "settings"+ ]+ },+ "builder": {+ "note": "flow, form, page and automation builders",+ "styles": [+ "framed-sheet",+ "achromatic-ledger"+ ],+ "screens": [+ "builder",+ "list",+ "settings"+ ]+ },+ "creator": {+ "note": "newsletters, creator studios, audience insights",+ "styles": [+ "accent-ladder",+ "editorial-greeting",+ "true-black-flat"+ ],+ "screens": [+ "overview",+ "analytics",+ "list"+ ]+ },+ "smb-admin": {+ "note": "small-business and SaaS admin with plans, onboarding and growth nudges",+ "styles": [+ "accent-ladder",+ "framed-sheet"+ ],+ "screens": [+ "overview",+ "list",+ "settings"+ ]+ },+ "workspace": {+ "note": "team hubs and personal homes",+ "styles": [+ "editorial-greeting",+ "achromatic-ledger"+ ],+ "screens": [+ "home",+ "inbox",+ "settings"+ ]+ },+ "community": {+ "note": "community, events and media back offices",+ "styles": [+ "true-black-flat",+ "accent-ladder"+ ],+ "screens": [+ "overview",+ "list",+ "detail"+ ]+ },+ "support": {+ "note": "support inboxes, queues, helpdesks",+ "styles": [+ "achromatic-ledger",+ "framed-sheet"+ ],+ "screens": [+ "inbox",+ "list",+ "settings"+ ]+ },+ "markets": {+ "note": "trading, research and monitoring read in long sessions",+ "styles": [+ "data-terminal",+ "true-black-flat"+ ],+ "screens": [+ "analytics",+ "list",+ "detail"+ ]+ },+ "report": {+ "note": "generated or exported reports with no app around them",+ "styles": [+ "achromatic-ledger",+ "framed-sheet"+ ],+ "screens": [+ "report"+ ]+ }}}diff --git a/skills/taste-skill/references/app-screens.md b/skills/taste-skill/references/app-screens.mdindex 276fc24..fbb99ea 100644--- a/skills/taste-skill/references/app-screens.md+++ b/skills/taste-skill/references/app-screens.md@@ -34,6 +34,25 @@ Taking the template's devices away is half the job, as it is on a page. The othethe product's real data, a screen that answers its one question first, and a grid whose arithmeticcloses.+**A warning learned in testing.** In the first blind round, screens built with this chapter were+clean, quiet and correct, and they lost to richer screens built without it. The judges' reasons were+the same every time, and each is now a rule below:++- **The first screen was thin.** One large chart of a flat line filled it, and half the blocks the+ brief asked for started below the fold. On a 1440×900 screen, every block the brief names shows its+ header and its first rows (§2.2).+- **The product was missing.** No name, no workspace, no mark: the screen could have belonged to+ anyone. The shell names the product and the scope (§3.2).+- **Restraint hid meaning.** A latency rise and a request rise were the same grey. Colour on a change+ says good or bad, not up or down (§5).+- **There was nothing to do.** No control for the job the screen exists for. The most frequent job is+ one click from the first screen (§2.2).+- **Rows ended ragged** and **a style's move was over-applied** (a tray around every card, an icon+ rail where people needed labels). Keep the move to where it carries meaning.++Quiet is the starting point, not the goal. A screen that a person would trust shows more of the+product than a template does: its people, its objects, its numbers and the one thing to do next.+## Contents1. When this applies@@ -88,12 +107,19 @@ in 8 to 12 lines:- **the people**: who opens this screen, how often (a glance once a day, or an eight-hour session),on what device;- **the jobs**: what they do next from here (approve, reply, pay, ship, invite), and which job comes- up most.+ up most;+- **the product's own things**: its name and mark, the workspace or account it is scoped to, the people+ in it (two partners, a team of six, the club's members), and the objects people recognise by sight+ (product photographs in a shop, cover art in a media tool, a map of the route). These are what make+ a screen belong to this product instead of to a template; plan where each one appears.Then write the data itself: a small dataset in a JSON or JS file that the screen renders from, withbelievable names, amounts that add up to their totals, dates in order and a unit on every figure.Totals are computed from the rows, never typed in separately. Small numbers stay small: the studied-screens show new accounts with 1, 6 or 9 of something, drawn honestly at their real size.+screens show new accounts with 1, 6 or 9 of something, drawn honestly at their real size. Write the+figures that must agree as assertions in the data file (`console.assert(sold - cancelled === rsvps)`,+the bins sum to the total, the parts to the whole) and read the console: in testing, a ticket table+that did not reconcile with its own KPI cost a judge's trust in the whole screen.### 2.2 Name the screen's one question@@ -113,6 +139,21 @@ Then list the screen's blocks as the answers to its next questions, one line eacrun lists claims. A block with no question is deleted. This is how you avoid the stock order of KPIrow, big chart, two small charts, table.+Three more lines, each tested:++- **Everything the brief names is on the first screen.** At 1440×900, every block the brief asks for+ shows its header and its first rows or its figure. Size the headline block to the question (about+ 200-360px tall), cap long lists at 4-6 rows with "View all", and put time-sensitive blocks (bills+ due, SLAs running out, a failed deploy) before long tables. A chart whose line is flat for most of+ the window does not get the full width: give it two-thirds and put the next answer beside it.+- **The most frequent job is one click away.** Name it ("pack the orders due today", "reply to the+ oldest breach", "redeploy the failed build") and put its control where the answer shows: a primary+ button in the title row, an action on the row that needs it, a "View logs" on the failed item. A+ screen with no control for its main job reads as a report, not as a tool.+- **Show the evidence beside the answer.** A judge trusts "Error rate 0.28%" more with its spike+ annotated ("peaked at 3.9% after the 23:28 deploy, reverted") than with the number alone. One line+ of explanation on the event that matters is worth more than a second chart.+### 2.3 Choose a style```bash@@ -244,6 +285,13 @@ No screen in the study puts a dark or saturated sidebar against a light canvas (- **Top and bottom.** The workspace or account switcher at the top of the sidebar (7 screens), at itsbottom (2), or in the top bar. The bottom holds a user row (8) or one upsell (8); one of thoseupsells is a filled accent button.+- **The product is named** (house rule, from testing). The product's mark and name sit at the top of+ the sidebar or rail, and the scope (workspace, team, project, account) is shown as a switcher or a+ breadcrumb. A screen whose product cannot be named from the screenshot reads as a template.+- **Labels by default.** A labelled sidebar unless the product has five destinations or fewer and the+ screen needs the width (a research or monitoring view); an icon rail always carries the product's+ mark at the top, a tooltip and an accessible name on every icon. Nav items are other screens, never+ anchors into the current page (a sidebar that scroll-spies one long page was marked down twice).### 3.3 Top bar@@ -298,7 +346,18 @@ inspector warns when the content stops well short of the right edge.screens): four KPI tiles in a three-column grid, orphaning the fourth; one card alone in athree-column row beside 810px of nothing; a card stretched to its neighbour's height with 250px ofblank under its legend. Choose the column count from the number of items, let a lone card span, and-do not match heights when the contents differ.+do not stretch a card's frame over empty space.++**Cards that share a row share a bottom edge.** In testing, rows whose cards stopped 26-190px apart+were marked down every time, by judges and by the inspector (`ragged-row`). Balance the row by its+content first: move a list's rows so the two columns hold the same number, cap both lists at the same+count, or pair blocks of similar height. Only when the contents cannot balance, stack the two blocks,+or let the shorter card fill the row height with its content top-aligned and the footer action (a+"View all", a total) pinned to its bottom so the extra height is not a hole.++**Narrow blocks do not span the canvas.** A table of five columns or fewer, or a list of six rows or+fewer, runs to about 760px at 1440 and pairs with the next block; stretched to 1300px it leaves+400-600px voids between a name and its first figure.### 4.3 The title@@ -357,6 +416,11 @@ do not match heights when the contents differ.- **The window in words**: "vs prior 30 days", "in the last 90 days", "from 0 (last 4 weeks)" (7 ofthe 9).- **Colour only the number**, or set the whole delta in grey.+- **Colour says good or bad, not up or down** (house rule, from testing). Every metric has a good+ direction: latency, error rate, cost, churn and time-to-reply are better when they fall. A change+ in the bad direction puts `--negative` on the number (or a small down-pointing glyph in that+ colour); a change in the good direction is `--positive` or grey. A judge read a 2.5× rise in errors+ set in the same grey as a rise in visits as hiding the screen's only bad news.- **Zero or undefined change is grey.** The study's commonest KPI failure is a zero or undefined changeshown as a signal: three identical green "up 100%" pills grown from zero, a ">999%", a bold red"0.00%", a green "+0". When the prior period was zero, write "+4 (new)"; when there is nothing to@@ -371,9 +435,11 @@ do not match heights when the contents differ.| Is it moving over time? | One line; an area only with a fill of 15% or less | 9 screens || How much per period? | Columns with square corners | 3 || How is it distributed? | A histogram with equal bins | 1 (its unequal bins are flagged) |-| Who ranks? | A sorted horizontal bar list, or the table row's fill as the bar | 3 |+| Who ranks? | A sorted horizontal bar list, or the row's fill as the bar in a one-figure list | 3 || What share? | A thin ring, or a 100% stacked bar with 2px seams; five parts at most | 5 || How far to the target? | A progress bar, both ends labelled, the fill the true ratio | 4 |+| How much of the plan is used? | A track as long as the plan, the spent part filled, what is already committed as a lighter segment, an overrun past the track's end in the negative colour (`Charts.plan`) | house rule |+| Has it drifted from its target? | One row per part: the current share as a bar with a 1px tick at the target (`Charts.bullet`); never two stacked bars to compare | house rule || Where? | A map with a list beside it; the list carries the magnitudes | 1 || Per period, and the running total? | The two side by side at equal width, with the same dates | 1 |@@ -433,6 +499,14 @@ to 5.2.and "Expert 2,000"); the fill is the true ratio, so 303 on that scale fills 22px of 392. A zero hasno stub (a 6px stub at zero is flagged).- **Tooltips** are bare text or a plain box without an arrow: label and value on one line.+- **Annotate the event that matters.** A step or a spike more than about three times the usual change+ gets a 1px marker and a 12px label naming its cause ("Deploy a3f09c1", "Newsletter featured");+ reference lines (a budget, an SLO, a start time) are 1px dashed with their label at the end. In+ testing, an unexplained jump was the first thing a judge asked about. `Charts.line` and+ `Charts.bars` take `annotations` and `reference`.+- **Use the helper, then extend it.** Draw charts with `assets/charts.js` and add what a chart needs to+ it, rather than writing new axis code: in testing, every chart written from scratch on a phone put+ its y labels on top of its line.- **Short and empty histories are drawn honestly**: a flat zero line with one spike, missing bars forempty periods, no padded y-range, no "No data" picture. Do not give one point the screen's largestplot, though: a lone dot in a full-size grid reads as barren (flagged once).@@ -506,8 +580,13 @@ to 5.2.#04250e, #ffedea with #831c1e.- Neutral states are monochrome chips with a glyph ("Public" with a globe).- A state machine uses one hue at three intensities: grey for off, the full hue for the call to- action, a dark tint for running. A saturated fill with white text only for that one call to action.+ action, a dark tint for running. A saturated fill with white text only for that one call to action,+ and only while it is rare: when more than about a fifth of the visible rows carry it, it becomes a+ stripe of black blobs louder than the data (marked down in testing); use the pale pair or a 6px dot+ with an ink label instead.- **One status mark per row.** A tag and a badge that say the same thing are flagged.+- **A chip is never squeezed.** Tags and pills are `flex: none; white-space: nowrap`: in testing a+ table column collapsed an environment chip to a 12px box with its word spilling out.### 7.7 Media@@ -520,10 +599,15 @@ list so the text starts on one edge (a 50px slot with the text 16px after it). M- **No pagination on an overview** (0 of 23). Cap the rows and link out: "View all" in the sectionheader, a 30px outlined button under the list, a full-width 32px bar. State the total ("3 tracks").-- Row actions: none on 9 screens; otherwise one kebab at the far right.+- Row actions: none on 9 screens; otherwise one kebab at the far right. When a row needs doing+ (a bill to pay, an order to pack, a failed deploy), its action is a visible ghost button or an ink+ text action in one fixed trailing column, at the same pitch for every row; never muted grey text,+ and never stacked under the amount so the rows change height.- Checkboxes only where bulk actions exist (one screen: 18px, 2px stroke, 3px radius).- Hover and selected: a 1px outline at 6px radius overhanging the panel by 1px, or a darker border- with a 1px ring. No hover that changes the fill was seen.+ with a 1px ring. No hover that changes the fill was seen. In a list that drives a detail pane (an+ inbox, a queue), the selected row takes the `--active` fill of the nav pill instead, so it cannot be+ mistaken for a focus ring or a hover (house rule, from testing).- Toolbar: one search, 30-36px tall (256x30, 252x36, 316x32).- **A full list screen** (house rule; the study has none): state the total above the table, keep theheader row in view while scrolling, and page or load more at the end with the range shown@@ -532,7 +616,9 @@ list so the text starts on one edge (a 50px slot with the text 16px after it). M### 7.9 Lists that carry data- **The row fill is the bar**: the row's rounded background (radius 8) as wide as its share of the- largest share; 44px rows, 2px gaps.+ largest share; 44px rows, 2px gaps. Only in a one-figure ranking list (a label and one value): in a+ row with several columns or two lines, the fill's edge cuts through the words (failed in testing).+ Planned against spent is a separate 6-8px track under the label (`Charts.plan`).- **Bar list**: a 64px pitch, a label line, then a 10px pill bar with the value 5px after its end; thelongest bar about 88% of the width; one colour, no track.- **Legend as table**: dot, name, pill, value and change on a 57px pitch.@@ -581,6 +667,17 @@ enough for the defaults.- **Destructive actions** (house rule; none in the study) go last, in a section of their own, as atext or outlined button in the negative colour, with the consequence in words and a confirmationthat names the object.+- **One view per area** (house rule, from testing). When settings span several areas (general,+ members, billing, notifications), each sidebar item opens its own view (a hash route is enough in+ a static build), with the area's name as the h1. One long page of every area, with the sidebar+ scrolling to anchors, put the first area the brief named four screens down and was marked down.+- **One save model per view**: every control saves itself and shows a quiet "Saved" stamp, or one+ Save per panel at the panel's bottom right. Never a mix of both on one view.+- **Show what the setting produces.** Beside the control that changes it, a small preview of the+ result (the invite email, the notification as it will arrive, the plan's next invoice) is the+ product-specific substance a settings screen otherwise lacks.+- A settings view opens with a usage strip only when usage is its question (a plan or quota view),+ and its figures stay smaller than its h1.### 8.3 Buttons@@ -594,7 +691,11 @@ white with a 1px border; a tertiary is text. The controls in one row share one h- **One grotesk.** All 23 screens use a neo-grotesk, and 14 use that one family alone. A second facealways has one job: a monospace for every number or for IDs only, a serif for one greeting, a brand- face kept to the wordmark or the switcher. Never three.+ face kept to the wordmark or the switcher. Never three. Axis ticks, chart notes and labels stay in+ the text face even when IDs are in a monospace.+- **App type is not display type.** The h1 stays at 18-32px and no figure reaches 48px: in testing, a+ 50px serif title and a 76px balance made a budgeting screen read as a landing page (the inspector+ warns at 34px and 48px).- **Sizes**:| Role | Range in the study | Median |@@ -778,14 +879,22 @@ takes more than 30% of a phone's width.than 12px.- **The title stays**, at 20-24px. Header actions move into a kebab, except the one primary.- **Filters** collapse into one row of chips or a Filters sheet; tabs scroll sideways inside their own- row, never the page.+ row, never the page. The first list row starts in the top 60% of the phone screen: three rows of+ filter controls above it pushed the list off the first screen in testing.- **KPIs**: a divided container becomes a 2-column grid, or a list with the label on the left and thevalue on the right. Never four squeezed columns.-- **Charts** go full width, 160-200px tall, with 3-4 x labels, the y ticks inside the plot area and a- legend of dots above.-- **Tables become lists of two-line rows**: the identity and the key number on line 1, two or three- secondary fields in 13px grey on line 2, the one action at the right. A table that must stay a table- scrolls inside its own frame with its first column fixed; the page never scrolls sideways.+- **Charts** go full width, 160-200px tall, with 3-4 x labels and a legend of dots above. The y ticks+ keep their own lane at the left (or move to the right edge); a tick label never sits on the line.+- **Tables become lists of two-line rows below about 640px**: the identity and the key number on line+ 1, the other fields the brief names in 13px grey on line 2 ("fra1 · 1m 38s"), the one action at the+ right. Fields move to line 2; they are never dropped. A table that must stay a table scrolls inside+ its own frame with its first column fixed; the page never scrolls sideways.+- **The tablet (641-1100px) is its own band**: the sidebar folds to the top bar, but tables keep four+ or five columns with secondary fields as sublines, two narrow panels stack once either would be+ under about 340px, and the identity column is never the one truncated while another has room.+- **Blocks that carry an action move up, not down**: a right rail with an action (low stock and its+ Reorder, bills due and Pay) becomes a one-line summary row above the list ("5 items low · Review"),+ never a block under twenty orders.- **Several panes** (a list and its detail, an inbox): one region at a time. Choosing a row pushes thedetail; back returns to the list at its scroll position.- **Settings**: the label column stacks above its panel.@@ -832,6 +941,10 @@ Still banned, as on pages, and checked:| A hero header, a greeting with an emoji, an illustrated welcome banner | A noun title at 24px || Pagination under a five-row overview list | Capped rows, "View all", the total || Violet and indigo accents; cream with terracotta | The dealt style's palette |+| A landing-page title (over 32px) or a figure at 48px or more | An 18-32px title; figures at 16-40px |+| Icons in boxes repeated down a list or on top of every peer card, tinted or neutral | One plain 16px icon where it helps, or none |+| Every row a different hue, a "left" amount in green on every budget row | Grey for what is fine; colour only on the rows at risk or over |+| A screen that names no product and offers no action | The product's mark and scope in the shell; its main job one click away |**On violet and indigo.** 10 of the 23 studied screens use violet or indigo, always as a data hue or asingle control. The ban is the owner's taste, not a finding of the study: the library deals otherdiff --git a/skills/taste-skill/scripts/lib/probe.mjs b/skills/taste-skill/scripts/lib/probe.mjsindex 463ebfa..bc1b795 100644--- a/skills/taste-skill/scripts/lib/probe.mjs+++ b/skills/taste-skill/scripts/lib/probe.mjs@@ -699,7 +699,7 @@ export function app() {const sh = cs.boxShadow !== 'none' ? cs.boxShadow : '';if (!filled && !bordered && !sh) continue;if (!(el.innerText || '').trim()) continue;- panels.push({ w: Math.round(r.width), h: Math.round(r.height) });+ panels.push({ el, w: Math.round(r.width), h: Math.round(r.height), top: Math.round(r.top + SY), left: Math.round(r.left), bottom: Math.round(r.bottom + SY), right: Math.round(r.right) });const rad = Math.round(parseFloat(cs.borderTopLeftRadius) || 0); radii.set(rad, (radii.get(rad) || 0) + 1);if (bordered) { const c = contrast({ ...bc, a: 1 }, bg.a >= 0.9 ? bg : ground); if (c >= (lum(ground) > 0.4 ? 1.45 : 1.9)) { heavyBorders++; if (borderSamples.length < 3) borderSamples.push(`${hex(bc)} on ${hex(bg.a >= 0.9 ? bg : ground)} (${c}:1)`); } }if (sh) {@@ -714,13 +714,25 @@ export function app() {}if (cs.backdropFilter && cs.backdropFilter !== 'none') glass++;}- // 4. the icon-in-a-tinted-square habit: small boxes with a coloured fill holding one icon, repeated- const chips = [];+ // top-level panels only (a card inside a panel is part of it): rows that end ragged, and how many+ // panels start on the first screen+ const panelEls = new Set(panels.map((p) => p.el));+ const tops = panels.filter((p) => { for (let a = p.el.parentElement; a && a !== B; a = a.parentElement) if (panelEls.has(a)) return false; return p.w < W * 0.97 || p.h < H * 2; });+ const ragged = [];+ for (let i = 0; i < tops.length; i++) for (let k = i + 1; k < tops.length; k++) {+ const a = tops[i], b = tops[k];+ if (Math.abs(a.top - b.top) > 4 || a.w < 200 || b.w < 200 || (a.right > b.left - 4 && b.right > a.left - 4)) continue; // side by side, same row+ const diff = Math.abs(a.bottom - b.bottom), tall = Math.max(a.h, b.h);+ if (diff > Math.max(24, tall * 0.12)) ragged.push({ diff, top: a.top });+ }+ const firstScreen = tops.filter((p) => p.top < H - 48).length;+ // the icon-in-a-tinted-square habit: small boxes with a coloured fill holding one icon, repeated+ const chips = []; let tiles = 0;for (const el of all) {const r = el.getBoundingClientRect(); if (r.width < 24 || r.width > 64 || Math.abs(r.width - r.height) > 4) continue;const cs = getComputedStyle(el); const bg = rgba(cs.backgroundColor); if (bg.a < 0.08) continue;const icon = el.querySelector('svg, i, img, [class*="icon" i]'); if (!icon || (el.innerText || '').trim().length > 2) continue;- const c = hsl(bg); if (c.s < 0.18 && bg.a > 0.5) continue; // a neutral grey square is an avatar or a plain button+ const c = hsl(bg); if (c.s < 0.18 && bg.a > 0.5) { if (r.width >= 28 && !el.closest('button, a, nav, aside, [role="navigation"]')) tiles++; continue; } // neutral: an avatar, a button, or a boxed iconchips.push({ hue: c.h, size: Math.round(r.width), radius: cs.borderTopLeftRadius });}const chipHues = new Set(chips.map((c) => Math.round(c.hue / 30)));@@ -755,6 +767,8 @@ export function app() {return {viewport: { w: W, h: H }, dark: lum(pageBg) < 0.2, ground: hex(pageBg),sidebar, topbar, canvas,+ layout: { panels: tops.length, firstScreen, ragged: ragged.slice(0, 6) },+ tiles,panels: { count: panels.length, radii: [...radii.entries()].sort((a, b) => b[1] - a[1]).slice(0, 6), heavyBorders, borderSamples, heavyShadows, softShadows, shadowSamples, glass },chips: { count: chips.length, hues: chipHues.size, samples: chips.slice(0, 4) },numbers: { cells: cells.length, leftAligned: leftNums, figures: figures.length, tabularShare, kpiMax: figures.length ? Math.max(...figures.map((f) => f.size)) : null },diff --git a/skills/taste-skill/scripts/lib/rules.mjs b/skills/taste-skill/scripts/lib/rules.mjsindex 2c8c613..b7b4ff6 100644--- a/skills/taste-skill/scripts/lib/rules.mjs+++ b/skills/taste-skill/scripts/lib/rules.mjs@@ -206,9 +206,17 @@ export function judgeApp(A, m, { width = A.viewport.w, allow = [] } = {}) {if (A.placeholders.length) add('FAIL', 'placeholder-data', `Placeholder data on screen: ${A.placeholders.join(', ')}.`, 'Use believable data for this product: real-looking names, amounts that add up, dates in order, units on every figure.');if (A.type.tiny > 2) add('FAIL', 'tiny-text', `${A.type.tiny} text blocks under 11px: ${A.type.tinySamples.join(', ')}.`, 'Nothing below 11px; secondary text 12px, data 13–14px.');else if (A.type.under13 > 0.45) add('WARN', 'tiny-text', `${Math.round(A.type.under13 * 100)}% of the text is under 13px.`, 'Data and labels read at 13–14px; keep 11–12px for sublines and axis ticks.');+ if (!mobile && A.layout) {+ if (A.layout.ragged.length) add('WARN', 'ragged-row', `${A.layout.ragged.length} pair(s) of cards in one row end at different heights (by ${A.layout.ragged.map((r) => r.diff + 'px').slice(0, 3).join(', ')}).`, 'Cards that share a row share a bottom edge: balance them by their content (the same number of rows, a block of similar height beside it), or stack them. In testing, ragged rows were marked down every time.');+ if (width >= 1100 && A.layout.panels >= 4 && A.layout.firstScreen / A.layout.panels < 0.5) add('WARN', 'below-fold', `Only ${A.layout.firstScreen} of ${A.layout.panels} blocks start on the first ${width}px screen.`, 'Every block the brief names shows its header and first rows on the first desktop screen: size the headline block to its question, cap long lists with "View all", and put time-sensitive blocks before long tables.');+ }+ if (A.title && A.title.size > (mobile ? 28 : 34)) add('WARN', 'app-title-size', `The h1 is ${A.title.size}px ("${A.title.text.slice(0, 40)}").`, 'An app screen is not a landing page: the title is 18-32px (20-24px on a phone).');+ if (A.numbers.kpiMax && A.numbers.kpiMax >= 48) add('WARN', 'kpi-size', `A figure is set at ${Math.round(A.numbers.kpiMax)}px.`, 'Figures run 16-40px on app screens; none of the studied screens reaches 48px. Size and isolation make a number loud, not display type.');+ if (A.type.sizes.length > 10) add('WARN', 'size-count', `${A.type.sizes.length} font sizes (${A.type.sizes.join(', ')}).`, 'App screens use 4-9 sizes (median 6): a scale such as 12/14/16/24 with one figure size.');+ if (A.tiles >= 4) add('WARN', 'icon-tiles', `${A.tiles} icons sit in neutral boxes repeated down the screen.`, 'A boxed icon on every row or card is still the template habit, tinted or not. Keep one plain 16px icon where it helps the eye, or none.');if (!A.title) add('FAIL', 'no-title', 'The screen has no h1.', 'Name the screen in an h1 at the top of the canvas (18–28px): "Overview", "Payouts", the project\'s name.');if (m && m.type && m.type.monoProseShare > 0.15) add('WARN', 'mono', `Monospace is ${Math.round(m.type.monoProseShare * 100)}% of the text.`, 'Monospace for IDs, keys and code only; numbers use tabular figures in the text face.');return out;}-export const RULE_IDS = ['headline-lines', 'statement-length', 'focal-point', 'hero-words', 'mixed-font-headline', 'eyebrow', 'mono', 'numbering', 'micro-label', 'emoji', 'gradient', 'gradient-text', 'shadow', 'text-shadow', 'button-fx', 'hairline', 'outlined-box', 'dashed', 'glass', 'icon-cards', 'card-rows', 'pill-nav', 'palette-claude', 'palette-terracotta', 'palette-cream', 'palette-purple', 'default-link', 'contrast', 'font-count', 'font-fallback', 'size-count', 'body-size', 'measure', 'small-text', 'all-centred', 'ui-wrapper', 'overflow', 'broken-image', 'no-hero', 'first-action', 'grey-body', 'blend-text', 'covered-text', 'clipped-text', 'pinned-over-picture', 'empty-screens', 'long-pin', 'side-scroll', 'few-pictures', 'no-real-pictures', 'no-footage', 'still-page', 'off-centre', 'lopsided', 'blank-gap', 'no-title', 'small-title', 'many-h1', 'untitled-section', 'edge-text', 'ragged-edges', 'sidebar-phone', 'unused-canvas', 'heavy-shadow', 'heavy-borders', 'radius-mix', 'icon-chips', 'numeric-align', 'tabular', 'rainbow-chart', 'placeholder-data', 'tiny-text', 'colour-sprawl'];+export const RULE_IDS = ['headline-lines', 'statement-length', 'focal-point', 'hero-words', 'mixed-font-headline', 'eyebrow', 'mono', 'numbering', 'micro-label', 'emoji', 'gradient', 'gradient-text', 'shadow', 'text-shadow', 'button-fx', 'hairline', 'outlined-box', 'dashed', 'glass', 'icon-cards', 'card-rows', 'pill-nav', 'palette-claude', 'palette-terracotta', 'palette-cream', 'palette-purple', 'default-link', 'contrast', 'font-count', 'font-fallback', 'size-count', 'body-size', 'measure', 'small-text', 'all-centred', 'ui-wrapper', 'overflow', 'broken-image', 'no-hero', 'first-action', 'grey-body', 'blend-text', 'covered-text', 'clipped-text', 'pinned-over-picture', 'empty-screens', 'long-pin', 'side-scroll', 'few-pictures', 'no-real-pictures', 'no-footage', 'still-page', 'off-centre', 'lopsided', 'blank-gap', 'no-title', 'small-title', 'many-h1', 'untitled-section', 'edge-text', 'ragged-edges', 'sidebar-phone', 'unused-canvas', 'heavy-shadow', 'heavy-borders', 'radius-mix', 'icon-chips', 'numeric-align', 'tabular', 'rainbow-chart', 'placeholder-data', 'tiny-text', 'colour-sprawl', 'ragged-row', 'below-fold', 'app-title-size', 'kpi-size', 'icon-tiles'];