Overlays

Notification Center

Bell-trigger inbox with unread badge and a scrollable list.

Import

tsx

import { NotificationCenter, NotificationList, NotificationRow } from "@cooud-ui/ui";

bash

npx cooud-ui add notification-center

Examples

Inbox

A bell-trigger inbox built on Popover. The badge counts unread items; clicking a row marks it read, and “Mark all read” clears them all. Pass an optional `footer` for a “View all” link.

tsx

const INITIAL: NotificationItem[] = [
  {
    id: "mention",
    title: "Ada mentioned you",
    description: "“@you can you review the payout rail PR?”",
    timestamp: "2m ago",
    icon: <MessageSquare aria-hidden="true" />,
  },
  {
    id: "star",
    title: "Your release hit 1,000 stars",
    description: "cooud-ui reached a new milestone.",
    timestamp: "1h ago",
    icon: <Heart aria-hidden="true" />,
  },
  {
    id: "invite",
    title: "New teammate joined",
    description: "Grace accepted your invite to Acme.",
    timestamp: "Yesterday",
    avatar: { fallback: "GR" },
    read: true,
  },
];

function NotificationCenterDemo() {
  const [items, setItems] = useState<NotificationItem[]>(INITIAL);

  return (
    <NotificationCenter
      notifications={items}
      onMarkAllRead={() => setItems((prev) => prev.map((i) => ({ ...i, read: true })))}
      onNotificationClick={(id) =>
        setItems((prev) => prev.map((i) => (i.id === id ? { ...i, read: true } : i)))
      }
      footer={
        <Button variant="link" size="sm" className="h-auto px-0">
          View all notifications
        </Button>
      }
    />
  );
}

API Reference

Generated from the component's exported types.

NotificationRowProps

Extends Omit<HTMLAttributes<HTMLButtonElement>, "id" | "title" | "onClick" | "onSelect">

Prop	Type	Default	Description
`notification`*	`NotificationItem`	—	—
`onSelect`	`(id: string) => void`	—	Fired with the notification id when the row is activated.

NotificationListProps

Extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect">

Prop	Type	Default	Description
`notifications`*	`readonly NotificationItem[]`	—	—
`onSelect`	`(id: string) => void`	—	Fired with the notification id when a row is activated.
`emptyState`	`ReactNode`	—	Replaces the built-in "You're all caught up" empty state.

NotificationCenterProps

Extends Omit<ComponentPropsWithoutRef<typeof PopoverContent>, "onSelect" | "title">

Prop	Type	Default	Description
`notifications`*	`readonly NotificationItem[]`	—	Items to display in the inbox.
`onMarkAllRead`	`() => void`	—	Fired when the "Mark all read" affordance is activated.
`onNotificationClick`	`(id: string) => void`	—	Fired with the notification id when a row is activated.
`title`	`ReactNode`	`"Notifications"`	Header heading text.
`emptyState`	`ReactNode`	—	Custom empty-state content (defaults to "You're all caught up").
`footer`	`ReactNode`	—	Optional footer rendered below the list (e.g. a "View all" link).
`className`	`string`	—	Class names for the popover panel.