Skip to content

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/ui compiles with noUncheckedIndexedAccess off 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.tsx adds an imperative toast.* 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.

Internal documentation. Not for clients.