Frontend Overview

We’re locking in a repeatable, testable front-end architecture that lets us ship fast without regressions.

UI Components  →  Data Hooks (React Query)  →  Service Layer (lib/actions)  →  HTTP Adapters (fetchWrapper*)

• UI: render + interaction, no data orchestration
• Hooks: caching, invalidation, pagination
• Services: shape/validate data, call adapters
• Adapters: tokens, headers, base URLs, error mapping

Objectives

• Predictable state flow; minimal developer surface.
• High‑leverage tests that catch 80% at the right seams.

Non‑Goals

• Large renames or folder reshuffles.
• Rewriting business logic or swapping state libraries.

Success Criteria

• CEO demo flows covered by Playwright and green in CI.
• 2–3 core screens on useInfiniteList + domain hooks.
• <10 shared hooks adopted repo‑wide; PRs smaller & consistent.