ADR-002: HeroUI v3

Status: Accepted

Context

We need a robust, accessible, and themeable UI component library that integrates cleanly with Tailwind CSS.

Decision

We chose HeroUI v3.

Rationale

HeroUI v3 offers accessible compound components with dot notation, built-in ARIA support, keyboard navigation, and seamless styling compatibility with Tailwind CSS.

Consequences

Component usage follows v3 compound component APIs (e.g., <Card.Header>, <Tooltip.Trigger> instead of legacy monolithic component wrappers).