Skip to contentKino
Skip to Content

Notification center

A bell with how many are unread, which opens the notifications grouped by day, with All and Unread tabs. Short rows, a feed with actions in its rows, or an inbox archived down to empty.

Preview

Short rows, many to a screen, for an app that sends a lot of small news. Under the pointer the time gives way to Mark as read; opening a row marks it read.

npx shadcn add https://kinoui.com/r/notification-center.json
Kino

Examples

Feed

Led by the people in it, with what they wrote quoted under them and an invite answered in its row. The answer stays on the row, and the row is read.

npx shadcn add https://kinoui.com/r/notification-center.json
Kino

Inbox

Notifications are archived once dealt with, down to an empty list. Archive all read clears what’s been seen, and Undo puts it back until the panel closes.

npx shadcn add https://kinoui.com/r/notification-center.json
Kino

Installation

npx shadcn@latest add https://kinoui.com/r/notification-center.json
Files
lib/number-format.tslib/reduce-motion.tslib/resize.tslib/roll.tsxlib/refs.tslib/swap.tsxlib/run-progress.tscomponents/kino/animated-number.tsxlib/highlight.tslib/flow.tscomponents/kino/avatar.tsxcomponents/kino/badge.tsxcomponents/kino/spinner.tsxcomponents/kino/button.tsxcomponents/kino/empty.tsxlib/pill.tslib/scroll.tscomponents/kino/tabs.tsxlib/popup.tslib/glide.tsxcomponents/kino/tooltip.tsxlib/announce.tsxlib/controllable.tslib/dates.tslib/grip.tslib/panel.tsxcomponents/kino/sheet.tsxcomponents/kino/drawer.tsxcomponents/kino/popover.tsxlib/roomy.tslib/popover-sheet.tsxlib/settle.tscomponents/kino/notification-center/notification-center.tsxcomponents/kino/notification-center/notification-parts.tsxcomponents/kino/notification-center/notification-bell.tsxcomponents/kino/notification-center/notification-list.ts
Packages
@base-ui/reactclass-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

NotificationCenter

PropTypeDefaultDescription
variant'triage''feed''inbox''triage'triage: short rows, many to a screen. feed: led by the people, what they wrote quoted, and each notification’s actions as buttons in its row. inbox: rows are archived, with Undo until the panel closes.
notificationsNotificationItem[]NoneThe notifications, in any order: they show newest first. Give them with onNotificationsChange to own them, or use defaultNotifications.
onNotificationsChange(notifications: NotificationItem[], change: NotificationChange) => voidNoneCalled with the notifications after a change, and what changed: { reason, ids, action? }, where reason is read, unread, action, archive or restore, so your server can be told.
onOpenNotification(item: NotificationItem, event: MouseEvent) => voidNoneCalled when a row is opened, before its link is followed; prevent the event to stay. A row opens with an href or with this. Opening it marks it read and closes the panel.
footerReactNodeNoneUnder the list, such as a NotificationSettingsLink.
tab'all''unread''all'The tab that shows. With onTabChange to own it, or defaultTab.
openbooleanNoneWhether the panel is open. With onOpenChange to own it, or defaultOpen.
modalbooleanfalseWhether the popover traps focus. The sheet on a phone traps it too, unless this is false.
titlestring'Notifications'The panel’s title, which also names the bell: “Notifications, 3 unread”.
localestringNoneThe locale days and times are written in; the browser’s by default.
timeZonestringNoneThe time zone a day starts in; the visitor’s own by default.

NotificationItem

PropTypeDefaultDescription
idstringNoneUnique among the notifications.
atstringNoneWhen it happened, as an ISO instant (2026-11-17T09:42:00Z). Today shows how long ago; earlier days, the time.
readbooleanNoneWhether it has been read.
titleReactNodeNoneWhat happened, which names the row: “Maya Chen assigned you KIN-142”.
descriptionReactNodeNoneA line of detail, such as a comment’s first words. Triage leaves it out.
mediaReactNodeNoneWho did it, as an Avatar, or an icon for news from your app.
hrefstringNoneWhere opening the row goes.
actionsNotificationAction[]NoneButtons in the row, in the Feed: { label, run, done, variant? }. While run runs both are held; once it has run they give way to done, and the row is read. A throw keeps them, with an error.
donenumberNoneWhich of its actions was taken, by index: the row shows that action’s done.
PropTypeDefaultDescription
childrenReactNode'Notification settings'What it says.

Accessibility

  • The bell’s name carries the count: “Notifications, 3 unread”. The badge on it is hidden from screen readers, and a notification that arrives is announced with how many are unread.
  • The panel is a dialog named by its title. It opens with focus on the picked tab, so Enter never marks everything read, and Escape closes it with focus back on the bell.
  • Each row is an article named by its title, which is a link or a button covering the row, and “Unread” is read before it. An unread title is in full colour and medium weight; a read one is muted and regular, so unread never shows by colour alone. Its own buttons are named, described by the title, and show on hover or keyboard focus, or always on a touch screen.
  • Nothing is marked read by being seen. When a row leaves, focus goes to the same button in the row that takes its place, or to the tab once none is left, and every change is announced: Marked as read, Archived, and where Undo is.
  • Days and times follow the locale, and a time in a right-to-left page reads in its own direction.