Skip to content

2001105254-netizen/RacePulsePH / .agents/skills/racepulse-runner-mobile-ui

racepulse-runner-mobile-ui

Verified

Architect high-density, thumb-zone mobile and foldable Runner UI views with anti-slop spatial discipline and Android safe-area compliance. Use when building or refactoring RacePulsePH runner screens, sheets, queues, or adaptive split panes.

RacePulse runner mobile UI architecture

Enforce high-density mobile Runner UI ergonomics, one-handed thumb-zone reach, and adaptive split-pane layouts across RacePulsePH runner screens (src/components/RunnerDashboard.tsx, src/components/runner/, src/components/CustomerForm.tsx, src/components/WorkspaceShell.tsx, src/components/BottomNav.tsx, and src/components/ui/DialogSurface.tsx).

Load with: antislop, antislop-layoutmobile, antislop-human, android-layout-specialist. Related: racepulse-responsive-ui, racepulse-feedback. Rules upheld: C-1, C-2, C-3, C-4, C-5, R-02, R-03, R-11, R-15, R-25, R-26, R-27, R-31, R-32, R-34, R-35, R-36, R-37, R-39, R-40. Detail: mobile architecture.

Checklist

CheckReasonEvidence
Strip nested card wrappers, heavy drop shadows, decorative hero banners, and redundant row iconsPrevents vertical waste so at least 78% of a 375x812 viewport shows runner data (R-03, C-1)Inspect RunnerDashboard.tsx and runner panels at 375x812 in Playwright
Cap root mobile gutters at 12px-16px (px-3 or px-4) and card padding at 12px (p-3)Maximizes horizontal line width on 320px and 375px phones without overflow (R-03)Measure computed padding and scrollWidth <= innerWidth at 320px and 375px
Replace stacked equal-weight KPI grids with a single compact divide-x telemetry strip under 96px using tabular-numsEliminates vertical bloat and numeric layout jitter on live updates (C-1, R-03)Inspect telemetry strip bounding box height and font-variant-numeric
Architect Active Run / Pass Execution with 60-70% upper canvas, floating top status pill (top: max(12px, env(safe-area-inset-top))), and 3-detent bottom sheet (Peek 20%, Half 50%, Expanded 90%)Keeps route/progress visible while anchoring primary actions in thumb reach (C-3, R-03)Click detent controls and verify upper canvas plus sheet heights on 375x812
Format Queue & Triage views with a 48px header, 40px sticky segmented filter rail, and 3-point divide-y rowsShows 3-4+ actionable rows above the fold on 375x667 and 390x844 without scrolling (R-03, C-1)Count visible queue rows above the fold at 375x667 and 390x844
Convert centered modals and confirmations into bottom-anchored sheets (items-end sm:items-center) via DialogSurfaceKeeps dismissals and primary confirmations inside single-handed thumb reach (R-03, R-32)Open bib claim, QR scanner, profile, and delete modals at 375x812
Ship zero-CLS exact-height skeletons, a 28px non-blocking offline/sync top banner, compact empty states, and IME-aware bottom-nav hidingPrevents layout shift, preserves offline race-day clarity, and keeps inputs clear of keyboards (R-27, C-4)Test offline state, loading state, and input focus on 375x812
Transition at >= 600px from bottom bar (56px + env(safe-area-inset-bottom)) to a vertical NavigationRail and two-pane split (340px left queue + flexible right canvas) inside 100dvhSupports foldables, tablets, and phone landscape with independent single-scroll panes (R-03, C-4)Capture and inspect 600x900 and 844x390 viewports
Anchor primary progression CTAs in the bottom 35% thumb arc with >= 44x44px (48x48dp) targets and zero top-corner primary workflow buttonsPrevents awkward top-corner thumb strain and missed taps on touch screens (R-03, R-39)Verify button bounding rects and hit target dimensions in Playwright

Stack mapping

  • Root safe-area tokens and edge-to-edge viewport live in index.html, src/index.css, and src/access-ui.css.
  • Mobile navigation bar, vertical rail, and shell container live in src/components/BottomNav.tsx and src/components/WorkspaceShell.tsx.
  • Runner queues, active race pass canvas, registration flow, friends, and engraving live in src/components/RunnerDashboard.tsx, src/components/runner/RunnerEventsPanel.tsx, src/components/runner/RunnerAllRacesPanel.tsx, src/components/runner/RunnerMyRacesPanel.tsx, src/components/runner/RunnerFriendsPanel.tsx, and src/components/CustomerForm.tsx.
  • Bottom sheets and confirmations route through src/components/ui/DialogSurface.tsx, src/components/AccountPrivacyModal.tsx, src/components/QrScannerModal.tsx, and src/components/DeleteAccountModal.tsx.

Not covered

  • Organizer timing console, admin RBAC workspace, and native Gradle/Capacitor plugin migration belong to iso-ui-layout-auditor, racepulse-access, and capacitor-android-architect.
  • App-wide exhaustive screen audit certification belongs to racepulse-all-screen-audit.

Verify

  1. Run npm run lint and npm run build from the repository root; both must exit 0.
  2. Verify Playwright screenshots across 320x568, 375x812, 390x844, 600x900, 844x390, and 1440x900 in both light and dark modes with zero horizontal overflow (scrollWidth <= innerWidth) and zero console errors.
  3. Deliver the AGENTS.md PASS/FAIL report with interactive click-through evidence, guard exit codes, and a one-line purpose log.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall