Keep EdgeQuake WebUI pages visually consistent - one page frame (gutter, max width, vertical rhythm), one page-title style, one focus ring, and DOM-geometry checks. Use when adding or restyling a route, page header, toolbar, settings pane, or any layout in edgequake_webui, or when a page looks misaligned, clunky, or inconsistent with its siblings.
97%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Reference quality bar: the calm, structured layout of gr8r-studio (one content
gutter, one title size, subtle borders, 4pt spacing). Every route must read as
the same product.
All routes render content inside PageShell (src/components/shared/page-shell.tsx).
Never reinvent the inset with px-*, p-page, container mx-auto, or mx-auto max-w-*.
| Prop | Use for |
|---|---|
| (default) | Normal scrolling page, max width --page-max (1200px) |
narrow | Forms and single-card reading columns (max-w-3xl) |
wide | Workspace surfaces that own full width (max-w-none) |
scroll={false} | An inner pane owns vertical scroll (documents, graph, query split) |
flush | Only when the surface draws its own edge-aligned chrome (pane rail) |
Tokens live in src/app/globals.css:
--gutter 24px (16px under 900px), --page-max 1200px--page-pad-top 24px, --page-pad-bottom 48px (16 / 32 under 900px)eq-gutter utility = left and right padding of --gutterThe header (layout/header.tsx) and breadcrumb (layout/dynamic-breadcrumb.tsx)
also use eq-gutter, so the page title, the breadcrumb, and the first block share
one left edge.
PageHeader (shared/page-header.tsx) or an <h1> with
text-[1.375rem] font-semibold leading-snug tracking-[-0.012em].text-[0.8125rem] leading-relaxed text-muted-foreground max-w-[70ch].<h1> never lives inside a pane,
because that pushes it to the pane's x-offset (a real bug seen on /graph).<h1>. Headings never skip levels
(empty states use <h2> under an <h1> page, not <h3>).focus-visible:ring-ring focus-visible:ring-2 focus-visible:ring-offset-1 focus-visible:ring-offset-background. Do not use ring/50.h-8, icon size-7, touch size-11.icon-sm/icon, never bare 16px glyphs without padding.@theme inline tokens and (--var) arbitrary values
(max-w-(--page-max)), not hard-coded hex values.<PageShell> with the right prop from the table above.PageHeader or the title classes; one <h1>, no skipped heading levels.eq-gutter inside a full-width border container, then the same max-width wrapper.PageShell and gap tokens).data-testid and data-tour attributes that specs rely on
(spec100-*, spec099-*, graph-header, breadcrumb-bar).Screenshots are for humans. Agents verify with getBoundingClientRect:
<h1>, the breadcrumb, and the first content block must match
(within 1px) on /, /documents, /knowledge, /costs, /members, /query,
/graph, /pipeline, /workspace, and /settings (settings: h1 aligns with its
content column, not with the nav rail).overflow: visible text clipped by a truncating parent unless it
has a title attribute.gap-2.5) or a real space. Measure bounding boxes, not textContent.Run the focused specs after any frame change:
cd edgequake_webui
PLAYWRIGHT_BASE_URL=http://localhost:3000 npx playwright test \
e2e/spec100-workspace-cls.spec.ts e2e/spec100-graph-cls.spec.ts \
e2e/spec100-pipeline-cls.spec.ts e2e/spec100-breadcrumb-slot.spec.ts \
e2e/spec099-documents-scroll-layout.spec.ts e2e/spec175/settings-gates.spec.ts \
e2e/ui-fixes-verification.spec.ts --project=chromium --workers=1Set PLAYWRIGHT_BASE_URL to skip the config's port probe; without it the
config may try to start a second dev server on :3010.
Unit: npx vitest run src/components/shared (page-header tests).
Lint and types: npx tsc --noEmit -p tsconfig.json, then npx eslint <touched files>.
Known pre-existing failures (not from frame work): 39 vitest files fail with
Cannot find package 'bun:test', and 2 tests in api-module-size.test.ts and
eligible-path.test.ts fail. document-manager.tsx has pre-existing
react-hooks/set-state-in-effect errors.
px-3, px-4, px-6, p-page, or container mx-auto on a route root.text-2xl, text-xl) on a route.ring-ring/50 or no focus ring at all.<h1> inside a split pane.mx-auto on a settings or pane content column that fights a left rail.raphaelmansuy/edgequake
7057883
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.