2001105254-netizen/RacePulsePH / .agents/skills/racepulse-launch-ux-states
racepulse-launch-ux-states
VerifiedAudit RacePulsePH above-the-fold primary actions, mobile breakpoints, sticky action bars, loading states, inline form error states and post-submission confirmation views. Use when building or reviewing public pages, registration flows or payment returns.
RacePulse launch UX and state completeness
Ensure every public and registration flow presents a clear primary action, holds up across phone and desktop viewports, and covers loading, validation error and completion states without losing user input.
Load with: antislop, antislop-layoutmobile, antislop-human, racepulse-feedback, racepulse-responsive-ui. Rules upheld: C-1, C-2, C-4, R-02, R-03, R-15, R-26, R-27, R-35. Detail: checklist and verification.
Checklist
| Check | Reason | Evidence |
|---|---|---|
| Place the primary action (race lookup, bib search or event registration) above the fold without eyebrow pill banners | Runners opening RacePulsePH on race morning need immediate access to results or registration (R-15) | Inspect src/components/PublicRaceLanding.tsx and src/components/PublicLiveRaceHub.tsx at 375x812 and 1440x900 |
Verify layout reflow across phone (375px), tablet (768px) and desktop (1280px+) with min-h-11 touch targets | Prevents horizontal scrollbars and cramped tap targets on mobile browsers (R-03) | Resize viewport across breakpoints and check src/components/BottomNav.tsx and workspace headers |
| Keep sticky mobile navigation or action bars compact and non-overlapping with form inputs and footers | Fixed bars that cover submit buttons block completion on small screens | Inspect src/components/BottomNav.tsx and persistent workspace footers in src/components/AccessWorkspace.tsx |
Render explicit loading states (src/components/RunningLoader.tsx or disabled button spinners) during async fetches and submits | Prevents double submissions and blank screens while Firestore or Functions respond (R-27) | Trigger initial load, race filtering and checkout creation and confirm visible loading feedback |
| Show field-level or form-adjacent error messages and preserve draft values when validation or network calls fail | Clearing a runner's form on error forces re-entry on mobile keyboards (R-27) | Submit invalid registration or engraving data and confirm the error message appears and inputs stay populated |
Render a clear post-action confirmation state or return view for registrations, PayMongo returns (?payment=pay_...) and engraving orders | Users need verifiable confirmation of their bib, pending webhook status or order queue state | Test free registration, ?payment= return handling in src/lib/payments.ts and order submission in src/components/CustomerForm.tsx |
Stack mapping
- Loading indicator:
src/components/RunningLoader.tsxand the inline shell status inindex.html. - Feedback and confirmations:
src/components/ui/FeedbackProvider.tsxandsrc/components/ui/DialogSurface.tsx(racepulse-feedback). - Responsive operational shells:
src/components/AccessWorkspace.tsxandsrc/access-ui.css(racepulse-responsive-ui).
Not covered
- Color contrast math and keyboard focus rings belong to
antislop-human. - SEO meta tags and
PublicNotFoundViewbelong toracepulse-launch-seo.
Verify
- Run
npm run lintandnpm run build. - Test empty, loading, error and completion states across
375pxand1280pxviewports and output the PASS/FAIL report with a purpose log.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| 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: 471k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |