Activity inbox: filter tabs with counts, a timeline grouped by day, unread dots, mark all read and inline actions. On its own or behind a bell.
Inbox panel
Filters with counts, a timeline grouped by day, unread dots (press one to mark the item read or unread), Mark all read and inline actions. Pressing an action marks its card read.
Notifications
4 unread
Today

Unread: Maya Chen mentioned you
Can you check the hero copy on the Halo Coffee site before we send it?
Unread: Halo Coffee approved the proposal
“Brand refresh, phase 2” is approved. You can schedule the kickoff.
Unread: Priya from Northwind left 3 comments
On Homepage v3: spacing in the hero and two copy edits.
You were added to Denzing rebrand
Jonas added you as a designer. You can see every file in the project.
Earlier this week
Jonas Weber asked for your review
Logo explorations, round 2 is ready for a look.
Unread: Invoice INV-0142 is overdue
Denzing's invoice was due 5 days ago.
Weekly backup finished
Every project file from last week is backed up.
Installation
Copies the component into src/design-system/ as your own source, with only the files it needs.
npx avesk-ui@latest add notification-centerBrings the 8 files it builds on (button.tsx, glyph.tsx, empty-state.tsx, icon.tsx, floating.tsx, person-avatar.tsx, scroll-area.tsx, segmented-control.tsx). The first time, it also adds the tokens and the cn() helper, imports the tokens in globals.css and installs clsx and tailwind-merge. Files already in your project are kept unless you add --force.
Import
Lives in src/design-system/components/notification-center.tsx.
import { NotificationCenter, NotificationBell } from "@/design-system/components/notification-center";Usage
<NotificationBell
notifications={notifications}
filters={[{ id: "mentions", label: "Mentions" }, { id: "clients", label: "Clients" }]}
onAction={(id, action) => handle(id, action)}
/>Examples
Bell and popover
NotificationBell in a top bar: the badge and the bell's name carry the unread count. Escape or a click outside closes the popover and focus returns to the bell.
Northlight Studio
Controlled
Pass onNotificationsChange and tab + onTabChange when the screen owns the list and the filter, for example to show the count elsewhere.
Filter: mentions · Unread in the top bar: 2
Notifications
2 unread

Unread: Maya Chen mentioned you
Can you check the hero copy on the Halo Coffee site?
Unread: Jonas Weber asked for your review
Logo explorations, round 2 is ready for a look.
Empty
An empty filter shows an EmptyState that says what will arrive here.
Notifications
No unread notifications
No notifications yet
When clients reply, approve proposals or pay invoices, you'll see it here.
When to use
Use it when
- Telling people what changed since they last looked: mentions, client replies, approvals, overdue invoices
- A bell in the top bar with an unread count
- An inbox column on a dashboard
Don’t use it when
- Confirming something the person just did → Toast
- A problem on the current screen that needs fixing → Alert
- A list of actions → Dropdown menu
Rules
- Give every notification a category that matches a filter, or it only shows under All
- At most one primary action per card; the rest are secondary
- Pressing an action marks the card read; the dot toggles read and unread by hand
- Group by time (Today, Earlier this week) with the group field; items in a group must sit next to each other
- Use a person's avatar when someone did it, a status mark (success, error…) when the system did
Properties
NotificationCenter
| Prop | Type | Default |
|---|---|---|
notifications * | Notification[] | – |
onNotificationsChange | (next: Notification[]) => void | – |
filters | NotificationFilter[] | Mentions, System |
defaultTab | string | "all" |
tab | string | – |
onTabChange | (tab: string) => void | – |
onAction | (notificationId: string, actionId: string) => void | – |
title | string | "Notifications" |
empty | { title: string; body?: ReactNode } | – |
className | string | – |
NotificationBell
| Prop | Type | Default |
|---|---|---|
notifications * | Notification[] | – |
onNotificationsChange | (next: Notification[]) => void | – |
align | "start" | "end" | "end" |
defaultOpen | boolean | false |
filters | NotificationFilter[] | Mentions, System |
defaultTab | string | "all" |
tab | string | – |
onTabChange | (tab: string) => void | – |
onAction | (notificationId: string, actionId: string) => void | – |
title | string | "Notifications" |
empty | { title: string; body?: ReactNode } | – |
className | string | – |
Notification
| Prop | Type | Default |
|---|---|---|
id * | string | – |
category * | string | – |
group | string | – |
title * | string | – |
description | ReactNode | – |
timestamp * | string | – |
dateTime | string | – |
unread | boolean | – |
person | { id: string; name: string; src?: string } | – |
status | "neutral" | "information" | "success" | "warning" | "error" | "neutral" |
icon | IconName | "bell" |
actions | { id: string; label: string; variant?: "primary" | "secondary" }[] | – |
* required
Accessibility
- The bell's accessible name includes the count ("Notifications, 4 unread"); the badge itself is hidden from screen readers
- The popover is a non-modal dialog: focus moves into it, Escape or a click outside closes it and focus returns to the bell, tabbing out closes it
- The unread count is a live status, so Mark all read is announced
- Unread items say "Unread:" before their title; the dot is a real button named "Mark … as read/unread"
- Filters are a SegmentedControl (radio group with arrow keys); the list is a focusable ScrollArea