Diamond Diamond

ui · 6 variants · 1 categories

Toast

Temporary notifications built on @radix-ui/react-toast — ToastProvider + useToast() hook for imperative dispatch, plus a static <Toast /> for previews. Six variants: success, undo, progress, error, minimal, action.

npx "@rueda.dev/gems-diamond" add toast
§01

Toasts

6 variants
SavedDraft updated
success
Message sent
undo
Uploading
progress
Failed to connectCheck your network
error
Copied to clipboard
minimal
Aria mentioned you"can you review this?"
action

Usage Guide

How to wire up this component in your app — props, callbacks, customization, and the conventions Diamond shares across the library.

Universal patterns

Every Diamond component shares the same prop conventions, so once you learn one you can predict the others.

  • variant — discriminated union of every visual option. Categories shown above are docs-only metadata; the prop is a flat string union.
  • accent — any CSS color string. Overrides --diamond-accent just for that instance via inline style. Cascades into hover, ring, and selection states.
  • asChild (when present) — renders the underlying primitive via @radix-ui/react-slot, letting you compose with <Link>, motion.button, etc.
  • className — merged with internal Tailwind classes via cn(). Use it to override layout, spacing, or colors.
  • Native HTML attributes (onClick, aria-*, data-*, ref, etc.) flow through to the root element without any whitelist.
  • Diamond is the skin: zero domain state, zero fetch, zero providers. You wire data and reactions in your app code; the components just render and emit events.