Documentation
README
Web UI Component Development
Build React components following the four-tier architecture, with mandatory Storybook stories, data-testid attributes, and unit tests.
Four-Tier Hierarchy
Tier 0: ui/ -> shadcn/ui primitives (managed by CLI, rarely hand-edited)
Tier 1: common/ -> Reusable composed components (combine ui/ primitives)
Tier 2: layouts/ -> Page shells, structural wrappers (use ui/ + common/)
Tier 3: features/ -> Domain-specific views bound to routes (use all tiers)
Import rule: A tier may only import from lower tiers, never upward.
features/ -> layouts/, common/, ui/
layouts/ -> common/, ui/
common/ -> ui/
ui/ -> external packages only
File Structure
Tier 0 (ui/) β flat files, no subfolder
This is the opening of the README. Read the full README on GitHub.