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-iec-11581-10.md

View on GitHub
# ISO/IEC 11581-10: User Interface Icons (Framework & General Guidance)

## Standard Identity & Scope

- **Designation:** ISO/IEC 11581-10 (Information technology, User interface icons, Part 10: Framework and general guidance).
- **Scope:** Framework and design guidance for user interface icons covering symbol discriminability, semantic mapping, consistency, and preventing icon ambiguity across applications.

## Core Principles Audited by This Skill

1. **Zero duplicate icons across distinct navigation modules:** Every distinct navigation destination or operational tool must carry a unique, semantically distinct icon (or text-only tab) so users never confuse modules by scanning glyphs.
2. **Mandatory text labels or accessible tooltips:** Never ship unlabeled, mystery-meat icon buttons in consoles or mobile toolbars; attach visible concise text labels wherever space allows, and always include `aria-label` plus accessible tooltip/title on icon-only controls (`R-39`).
3. **Semantic relevance over decorative trend icons:** Reject generic placeholder glyphs (Sparkle, Magic, Robot, decorative lightning bolts) in favor of symbols directly matching the domain operation (`QrCode`, `Timer`, `Wifi`, `CheckCircle2`, `Ban` per `R-04`).
4. **Visual balance & consistent stroke weight:** Icons paired with text must stay aligned to the baseline (`inline-flex items-center gap-2`) and carry `aria-hidden="true"` when decorative alongside a visible label (`R-39`).

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

- **Sidebar & toolbar icon uniqueness:** Audit all icons in `DesktopSidebar.tsx`, workspace tabs, and right-dock headers to verify zero glyph reuse across distinct destinations (`Timing`, `Events`, `Broadcast`, `Access`, `Bib Studio`).
- **Label + icon pairing:** Sidebar items and primary toolbar CTAs always render icon + text label (`1` to `2` words) plus optional shortcut badge; icon-only compact controls (`Refresh`, `Fullscreen`, `Close`) must declare `aria-label` and `title`.

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

- **Labeled bottom navigation & action dock:** Every item in the mobile `BottomNav` or bottom action bar displays both a distinct icon and a short text label (`>= 11px-12px` readable label), never raw unlabeled icons.
- **No duplicate icons across bottom tabs and row actions:** Ensure row quick-actions (e.g., `Edit`, `Assign Chip`, `Verify`) use icons distinct from primary tab navigation icons.

## React & Tailwind Audit Patterns

```tsx
// Compliant labeled action button and accessible icon-only utility button
<button type="button" onClick={onScan} className="min-h-11 px-3 inline-flex items-center gap-2 rounded-lg bg-red-600 text-white text-sm font-semibold">
  <QrCode className="w-4 h-4 shrink-0" aria-hidden="true" />
  <span>Scan Bib QR</span>
</button>

<button
  type="button"
  onClick={onRefresh}
  aria-label="Refresh timing feed"
  title="Refresh timing feed (F3)"
  className="min-h-11 min-w-11 inline-flex items-center justify-center rounded-lg border border-[var(--border-default)]"
>
  <RefreshCw className="w-4 h-4" aria-hidden="true" />
</button>
```

## Inspection Evidence

- List every navigation module and toolbar button in the audited UI with its icon component name; confirm zero duplicate icon components map to different actions/modules.
- Confirm every icon-only `<button>` has a non-empty `aria-label` and accessible tooltip/title, and every icon paired with text sets `aria-hidden="true"` (`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