2001105254-netizen/RacePulsePH / .agents/skills/racepulse-runner-mobile-ui
racepulse-runner-mobile-ui
VerifiedArchitect 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
| Check | Reason | Evidence |
|---|---|---|
| Strip nested card wrappers, heavy drop shadows, decorative hero banners, and redundant row icons | Prevents 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-nums | Eliminates 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 rows | Shows 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 DialogSurface | Keeps 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 hiding | Prevents 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 100dvh | Supports 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 buttons | Prevents 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, andsrc/access-ui.css. - Mobile navigation bar, vertical rail, and shell container live in
src/components/BottomNav.tsxandsrc/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, andsrc/components/CustomerForm.tsx. - Bottom sheets and confirmations route through
src/components/ui/DialogSurface.tsx,src/components/AccountPrivacyModal.tsx,src/components/QrScannerModal.tsx, andsrc/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, andcapacitor-android-architect. - App-wide exhaustive screen audit certification belongs to
racepulse-all-screen-audit.
Verify
- Run
npm run lintandnpm run buildfrom the repository root; both must exit0. - Verify Playwright screenshots across
320x568,375x812,390x844,600x900,844x390, and1440x900in both light and dark modes with zero horizontal overflow (scrollWidth <= innerWidth) and zero console errors. - Deliver the
AGENTS.mdPASS/FAIL report with interactive click-through evidence, guard exit codes, and a one-line purpose log.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |