0055 — Forms use react-hook-form and Zod with thin HeroUI field adapters

​

Context

​

Decision

1. Form state is react-hook-form; validation is Zod, with the same schemas used by the API client and services.
2. HeroUI inputs are wrapped by thin FormField adapters that connect a HeroUI component to a react-hook-form controller and show Zod errors.
3. Adapters contain no business rules; a form builds on a schema, not the reverse.
4. Mobile forms reuse the schemas, not the web adapters.

​

Consequences

• One schema validates in the browser and on the server.
• The adapters are a small surface we maintain against HeroUI changes.

​

Enforcement

​

Supersedes and sources