Skip to content

2001105254-netizen/RacePulsePH / .agents/skills/iso-ui-layout-auditor

iso-ui-layout-auditor

Verified

Critique, audit, and refactor web and mobile UI screenshots or React/Tailwind code into high-density, zero-waste layouts governed by ISO ergonomics standards with separate Desktop (100vh) and Mobile (100dvh) checklists and blueprints. Use when auditing or refactoring consoles, dashboards, or field-staff views.

references/iso-9241-161.md

View on GitHub
# ISO 9241-161: Visual User-Interface Elements

## Standard Identity & Scope

- **Designation:** ISO 9241-161 (Ergonomics of human-system interaction, Part 161: Visual user-interface elements; Second edition 2025).
- **Scope:** Requirements and recommendations governing when and how standard GUI elements (toolbars, sticky headers, split panes, filter controls, buttons, list boxes, modal dialogs, status indicators) are selected and operated.

## Core Principles Audited by This Skill

1. **Element-to-task fit:** Select native semantic controls (`<button>`, `<a href>`, `<select>`, `<input>`, `<table>`) matched to the interaction type rather than clickable `<div>` elements or decorative wrappers (`R-39`).
2. **Persistent command & context elements:** Keep primary toolbars, search inputs, filter pills, and table column headers sticky (`sticky top-0`) while scrolling long datasets so context never scrolls off-screen.
3. **Standardized split-pane & dialog behavior:** Master-detail panes must scroll independently (`min-h-0 overflow-y-auto`), and dialogs/drawers must trap or manage focus cleanly, dismiss on `Escape`, and escape clipped parent stacking contexts via portals (`DialogSurface`).
4. **Clear visual state affordances:** Interactive elements must exhibit unmistakable default, hover, active, disabled, and `:focus-visible` states plus `cursor: pointer` / `cursor: not-allowed` (`R-32`, `R-39`).

## Desktop Console Criteria (`1080p` / `1366x768`, `100vh`)

- **Sticky table headers (`<thead class="sticky top-0">`):** Column headers remain locked at the top of the left `64%` scroll container (`flex-1 min-h-0 overflow-y-auto`) while scrolling hundreds of runners.
- **Filter pill & search toolbar:** Keep filter chips and search input pinned immediately above the master list inside the left pane so filtering never shifts the right-hand control dock.
- **Portaled modal dialogs:** Render blocking confirmations and overlays through `src/components/ui/DialogSurface.tsx` (`document.body` portal) so `overflow-hidden` split panes never clip dialogs.

## Mobile Field-Staff Criteria (`390x844`, `100dvh`)

- **Sticky bottom command bar (`bottom-0`):** Anchor primary actions in a persistent footer with sufficient bottom padding (`pb-24`) on the main scroll area so the final card row is never obscured (`racepulse-launch-ux-states`).
- **Scrollable filter strip:** Render filter pills in a clean horizontally scrollable row (`overflow-x-auto`) with `min-h-11` (`44px`) hit areas instead of wrapping into a 3-row block that steals vertical space.
- **Bottom-sheet modal ergonomics:** Convert desktop right-dock tools into modal bottom sheets with explicit close buttons and `Escape` support.

## React & Tailwind Audit Patterns

```tsx
// Independent scroll pane with sticky table header and min-h-0 flex discipline
<section className="flex flex-col flex-1 min-h-0 lg:w-[64%] border-r border-[var(--border-default)]">
  <div className="shrink-0 p-3 border-b border-[var(--border-default)] flex items-center gap-2">
    <input
      type="search"
      aria-label="Search runners by bib or name"
      placeholder="Search bib or name (Ctrl+F)"
      className="h-11 lg:h-9 flex-1 px-3 rounded-md border border-[var(--border-default)] bg-[var(--surface-page)] text-sm"
    />
  </div>
  <div className="flex-1 min-h-0 overflow-y-auto">
    <table className="w-full border-collapse">
      <thead className="sticky top-0 z-10 bg-[var(--surface-card)]">
        {/* Column headers stay pinned during scroll */}
      </thead>
      <tbody>{/* Rows */}</tbody>
    </table>
  </div>
</section>
```

## Inspection Evidence

- Verify `min-h-0` is applied on flex/grid scroll containers inside `lg:h-screen lg:overflow-hidden` so inner panes scroll without overflowing the `<body>`.
- Verify `<thead class="sticky top-0">` stays pinned when scrolling the left master table.
- Verify every button, tab, filter pill, and `<select>` shows visible `:focus-visible` outlines and works via keyboard (`R-32`, `R-39`).
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall