Files
SimpleFinanceDash/.planning/phases/02-layout-and-brand-identity/02-VALIDATION.md

4.0 KiB

phase, slug, status, nyquist_compliant, wave_0_complete, created
phase slug status nyquist_compliant wave_0_complete created
2 layout-and-brand-identity draft false false 2026-03-11

Phase 2 — Validation Strategy

Per-phase validation contract for feedback sampling during execution.


Test Infrastructure

Property Value
Framework Vitest 4.0.18 + @testing-library/react 16.3.2
Config file frontend/vite.config.ts (test section present)
Quick run command cd frontend && bun vitest run --reporter=verbose
Full suite command cd frontend && bun vitest run
Estimated runtime ~15 seconds

Sampling Rate

  • After every task commit: Run cd frontend && bun vitest run --reporter=verbose
  • After every plan wave: Run cd frontend && bun vitest run && bun run build
  • Before /gsd:verify-work: Full suite must be green
  • Max feedback latency: 15 seconds

Per-Task Verification Map

Task ID Plan Wave Requirement Test Type Automated Command File Exists Status
02-00-01 00 0 AUTH-01, AUTH-02, AUTH-04 unit stub bun vitest run src/pages/LoginPage.test.tsx W0 pending
02-00-02 00 0 AUTH-03 unit stub bun vitest run src/pages/RegisterPage.test.tsx W0 pending
02-00-03 00 0 NAV-01, NAV-02, NAV-03, NAV-04 unit stub bun vitest run src/components/AppLayout.test.tsx W0 pending
02-01-01 01 1 AUTH-01 unit bun vitest run src/pages/LoginPage.test.tsx W0 pending
02-01-02 01 1 AUTH-02 unit bun vitest run src/pages/LoginPage.test.tsx W0 pending
02-01-03 01 1 AUTH-03 unit bun vitest run src/pages/RegisterPage.test.tsx W0 pending
02-01-04 01 1 AUTH-04 unit bun vitest run src/pages/LoginPage.test.tsx W0 pending
02-02-01 02 1 NAV-01 unit bun vitest run src/components/AppLayout.test.tsx W0 pending
02-02-02 02 1 NAV-02 unit bun vitest run src/components/AppLayout.test.tsx W0 pending
02-02-03 02 1 NAV-03 unit bun vitest run src/components/AppLayout.test.tsx W0 pending
02-02-04 02 1 NAV-04 unit bun vitest run src/components/AppLayout.test.tsx W0 pending

Status: pending · green · red · ⚠️ flaky


Wave 0 Requirements

  • frontend/src/pages/LoginPage.test.tsx — stubs for AUTH-01, AUTH-02, AUTH-04
  • frontend/src/pages/RegisterPage.test.tsx — stubs for AUTH-03
  • frontend/src/components/AppLayout.test.tsx — stubs for NAV-01, NAV-02, NAV-03, NAV-04
  • frontend/src/components/ui/alert.tsx — must exist before any test imports it (install via bunx --bun shadcn add alert)

Manual-Only Verifications

Behavior Requirement Why Manual Test Instructions
Gradient background visually reads as pastel AUTH-01 Visual quality judgment Open login page in browser; gradient should feel like tinted paper, not a colorful splash
Wordmark gradient text is legible and branded AUTH-02 Visual quality judgment App name should display with gradient color fill; text must not disappear
Active nav item is clearly distinguishable NAV-03 Contrast perception Click different nav items; active state must produce a perceptible visual change
Sidebar collapse animation is smooth NAV-04 Animation quality Click SidebarTrigger; sidebar should animate smoothly without content jumps

Validation Sign-Off

  • All tasks have <automated> verify or Wave 0 dependencies
  • Sampling continuity: no 3 consecutive tasks without automated verify
  • Wave 0 covers all MISSING references
  • No watch-mode flags
  • Feedback latency < 15s
  • nyquist_compliant: true set in frontmatter

Approval: pending