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-920.md

View on GitHub
# ISO 9241-920: Guidance on Tactile and Haptic Interactions

## Standard Identity & Scope

- **Designation:** ISO 9241-920 (Ergonomics of human-system interaction, Part 920: Guidance on tactile and haptic interactions).
- **Scope:** Ergonomic requirements and guidance for touch, tactile, and haptic interactions, addressing physical reachability, touch target geometry, inter-target separation, and clear tactile/visual actuation feedback.

## Core Principles Audited by This Skill

1. **Thumb-zone ergonomics (Bottom `30%` Arc):** On handheld screens (`390x844`), place the highest-frequency primary actions inside the natural single-handed thumb reach zone (`bottom-0` sticky dock) rather than top-left or top-right corners.
2. **Minimum touch target geometry (`>= 44x44px` / `h-11`):** Every tappable button, filter pill, checkbox wrapper, tab, and row action on touch viewports must measure at least `44x44px` (`min-h-11 min-w-11`) to avoid miskeys while moving or wearing gloves outdoors (`R-03`).
3. **Adequate inter-target spacing (`>= 8px` gap):** Separate adjacent touch controls by at least `8px` (`gap-2`) so fat-finger taps never trigger neighboring destructive or wrong-row actions.
4. **Immediate actuation feedback:** Provide deterministic press feedback (`active:scale-[0.98]` under `150ms`, disabled loading states, and clear state confirmation via `FeedbackProvider`) while respecting `prefers-reduced-motion`.

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

- **Pointer + touch hybrid readiness:** Even on `1366x768` timing laptops that may feature touchscreens, keep primary action buttons comfortably clickable (`>= 36px` compact desktop toolbar controls, `>= 44px` primary commit buttons) with `>= 8px` spacing around destructive triggers.
- **Zero cramped icon clusters:** Avoid tightly packed `24px` icon rows without padding.

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

- **Sticky bottom action bar (`bottom-0`):** Anchor primary tasks (`Scan Race Bib QR`, `Check In`, `Assign Chip`) inside a persistent bottom bar with safe-area padding (`pb-[max(0.75rem,env(safe-area-inset-bottom))]`).
- **Scroll clearance (`pb-24`):** Ensure the runner list and card container include enough bottom padding so the sticky action bar never covers the final card's tap target (`racepulse-launch-ux-states`).
- **Single-column touch flow:** Keep card rows full-width with one obvious primary tap area (`min-h-11`) on Line 2 (`One-Tap Action`).

## React & Tailwind Audit Patterns

```tsx
// Sticky mobile bottom thumb-zone action dock with >= 44px targets and >= 8px gaps
<div className="lg:hidden fixed inset-x-0 bottom-0 z-30 border-t border-[var(--border-default)] bg-[var(--surface-card)]/95 backdrop-blur px-3 pt-2 pb-[max(0.75rem,env(safe-area-inset-bottom))] flex items-center gap-2">
  <button
    type="button"
    onClick={onOpenControlsSheet}
    className="min-h-11 px-4 rounded-lg border border-[var(--border-default)] text-sm font-semibold shrink-0"
  >
    Controls
  </button>
  <button
    type="button"
    onClick={onScanPrimary}
    className="min-h-11 flex-1 rounded-lg bg-red-600 text-white text-sm font-semibold inline-flex items-center justify-center gap-2 active:scale-[0.98] transition-transform duration-150 motion-reduce:transition-none"
  >
    <QrCode className="w-4 h-4" aria-hidden="true" />
    <span>Scan Race Bib QR</span>
  </button>
</div>
```

## Inspection Evidence

- Inspect every mobile interactive element in DevTools at `390x844` to confirm computed bounding box `width >= 44px` and `height >= 44px` (`min-h-11`), with `>= 8px` gap between adjacent controls (`R-03`).
- Confirm primary mobile CTAs reside in the lower `30%` (`bottom-0` sticky dock) and scroll containers apply `pb-24` or equivalent clearance.
- Verify no horizontal overflow occurs at `390x844` or `320x568`.
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