DESIGN.md at the repo root, which is the source of truth.
Principles
- Dark first. The main background is
#111111. Light mode exists but is secondary. - Flat. Depth comes from layering
zinc-800overzinc-900, never from borders, rings, or outlines. - One accent.
#00bbffis the only action color. Everything else is zinc neutrals. - Subtle motion. Animate entrances, exits, and state changes only. Keep durations at 300ms or less.
Colors
Brand
Card surfaces
Status
/10 background with matching text:
Shape and spacing
Outer cards use
p-4, inner items p-3.
Building UI
- Use HeroUI components, not raw HTML elements, and style them only with layout classes and the variants in
apps/web/src/components/shared/(DESIGN.md, “How to write frontend code”). - Import icons from
@icons, never raw SVGs or Unicode symbols. - Use
cn()to merge classes andmotion/reactfor animation. - Show toasts with
toastfrom@/lib/toast. The toaster is already mounted.
Do and don’t
Do
rounded-2xlon card containerszinc-800outer,zinc-900inner/10backgrounds for status colorsAnimatePresencefor exit animations
Don’t
border-,ring-, oroutline-in a card treerounded-lgon cards- Solid backgrounds on status badges
sonner,react-hot-toast, orframer-motionimports

