Tracker desk

A React block (a whole screen) in Beamline's SaaS admin app.

A product team's work tracker from one person's seat. The inbox: Priority and Other with unread counts, notifications moved through with J/K or arrows and read beside their issue; read, unread, snooze and delete change the notification and never the issue (said), snoozed ones leave until their time, and an issue that's gone is said. Saved views: the filters over the matching issues, edited filters said as unsaved until Save (a link never changes the saved view), the scope it's saved to (only you, a team, the workspace) with who can see it named before saving, owner and status summary beside it, read-only for others' views, a view you can't access refused with whose it is; and a Notify me menu that names exactly which changes notify you (entering the view, completed or canceled), never your own.

Use it for

An issue tracker's personal inbox and saved views, where notifications and work items must stay separate and a view's audience must be clear.

Not for

A sprint board (project-board).
A support inbox with SLAs (helpdesk-inbox).
Project timelines and dependencies (signature track).

Anatomy

navigation: the mark, Inbox with unread count, Favourites, views grouped by Personal, each team and Workspace
inbox: Priority · Other with counts, Show snoozed, the notifications (sender, issue, what happened, time); the reader: who did what and when, Mark read/unread, Snooze, Delete notification, the notification's text, the issue (key, title, status, priority, assignee, project, description)
view: name, scope chip, favourite, Notify me with what it notifies; filters with Add filter; unsaved said; the matching issues (key, title, status, priority, assignee); the rail: Save to, owner, who can see it, the link note, by status, Revert and Save view

States

inbox: priority empty; unread; selected; snoozed (hidden, or shown with its time); deleted with Undo; issue unavailable
view: personal, team, workspace; unsaved filters or scope; saving; save refused (kept); saved; read only; no access; no matches
subscription: none; entered only; closed only; both; notifications unavailable; change failed

Keyboard

J and K or the arrow keys move through notifications; every action has a visible button or menu item; navigation items are buttons with the current one marked

Motion

Only the parts' own feedback; nothing moves at rest.

Props

Prop	Type	Default	Description
`issues`	`TrackerIssue[]`	—	Work items with status, priority, assignee, team, labels and project.
`notifications`	`TrackerNotification[]`	—	Each about one issue, with read state, priority inbox flag and snooze; or defaultNotifications.
`views`	`SavedView[]`	—	Saved filters with scope, owner, favourite, subscription, canEdit and accessible; or defaultViews.
`onSaveView`	`(view) => Promise<{ error? } \| void>`	—	Save a view's filters and scope; an error keeps them unsaved.
`onSubscribe`	`(viewId, { entered, closed }) => Promise<{ error? } \| void>`	—	Change which view changes notify the person.
`notificationsAvailable`	`boolean`	—	False when the person's notifications are turned off: subscribing is unavailable, said.
`me` (required)	`string`	—	The person using it.
`now` (required)	`string`	—	Now, for snoozes.
`defaultNotifications`	`TrackerNotification[]`	—
`onNotificationsChange`	`((next: TrackerNotification[]) => void)`	—
`defaultViews`	`SavedView[]`	—
`onViewsChange`	`((next: SavedView[]) => void)`	—
`teams` (required)	`Record<string, number>`	—	Team sizes for the scope's "who can see it".
`workspaceSize` (required)	`number`	—
`onOpenIssue`	`((issueId: string) => void)`	—
`defaultSection`	`Section`	—
`defaultTab`	`"other" \| "priority"`	—
`defaultOpenId`	`string \| null`	—
`defaultDraftFilters`	`ViewFilter[]`	—	Open the view with these filters, not yet saved.
`timeZone`	`string`	—
`product`	`string`	—
`className`	`string`	—	Classes on the documented visual root; no override by default.
`ref`	`Ref<HTMLDivElement>`	—	Receives the documented native target or imperative handle; omitted by default.

Built from

Dependencies

lucide-react

Import

import { TrackerDesk } from "@beamline/tracker-desk";

Get it

Tracker desk is part of Beamline UI. Install the parts you need in your React app as compiled packages or editable source. Get Beamline · Connect your agent