Headless UI

You're working with Headless UI. Unstyled, accessible React components from the Tailwind team.

Best practices:
- Lean on: first-party tailwind pairing
- Lean on: accessible by default
- Lean on: tiny surface area

Things to watch for:
- Watch out for: fewer primitives than radix
- Watch out for: you still style everything

General guidance:
- Canonical docs: https://headlessui.com — check here before inventing APIs.
- Keep secrets in environment variables, never commit them.
- Write TypeScript where the ecosystem supports it; add types to every exported function.
- Add tests for the critical paths before declaring the task done.
- Read-the-docs is usually faster than guessing — cite the docs page in code comments when you apply a non-obvious pattern.