Appearance
ADR 0002: beUI replaces shadcn
- Status: Accepted
- Date: 2026-11-18
- Spec version: 1.0.0
Context
The scaffold shipped shadcn/ui primitives (Base UI, class-variance-authority, shadcn CLI). The owner chose beUI: animated, copy-the-source components on Motion and Tailwind that map onto the product (sidebar, tabs, toasts, availability scheduler, file upload, OTP input, todo list, approval card).
Decision
Remove all shadcn primitives and config. Vendor beUI components into packages/ui with scripts/beui.ts, tracked by packages/ui/beui.lock.json. Keep the shadcn token names (--background, --primary, ...) in globals.css because beUI is written against them.
Consequences
- No runtime dependency on a beUI package; we own the source and upgrade deliberately (
ui:status,ui:update). packages/uicompiles withnoUncheckedIndexedAccessoff so vendored code stays a plain copy.- beUI has no calendar and no video-annotation player; both are built in-house (spec steps 2 and 7).
- Toasts: beUI's stack is hook-driven, so
apps/web/src/lib/toast.tsxadds an imperativetoast.*for non-React callers.
Revisit when
beUI changes its licence, stops publishing the registry, or a needed component is missing and the in-house cost exceeds the cost of another source.