Dashboard 01 - Operational overview

v0.1.2

The canonical SignalOS page: collapsible sidebar, page header with actions, KPI metric strip, filter bar, and a paginated data table - pure composition of the shared widgets.

View as Markdown

Preview

Open full page ↗

Install & usage

npx shadcn@latest add @signalos/dashboard-01

Pulls the page source plus its widget dependencies (@signalos/tokens, @signalos/utils, @signalos/app-shell, @signalos/data-table, @signalos/filter-bar, @signalos/metric-tile) into your app - you own the copy. Requires access.

usage

// after: npx shadcn@latest add @signalos/dashboard-01
// mount the pulled page in a route, e.g. src/app/dashboard/page.tsx
import { Dashboard01 } from "@/components/blocks/dashboard-01/Dashboard01"

export default function Page() {
  return <Dashboard01 />
}

Props

Dashboard01Props

Prop	Type	Default	Description
navigationItems*	`NavigationItem[]`	-
activePath*	`string`	-	Current pathname for the sidebar active state.
LinkComponent	`ComponentType<AppShellLinkProps> \| undefined`	-	Router link renderer for the sidebar; plain <a> by default.
brand	`ReactNode`	-	Sidebar brand block.
pageTitle	`string \| undefined`	"Overview"
pageSubtitle	`string \| undefined`	-
actions	`ReactNode`	-	Right-aligned header actions (buttons, menus).
metrics*	`MetricTileProps[]`	-	KPI strip, one tile per entry (max 4 recommended).
search	`FilterBarSearchConfig \| undefined`	-	Search box wiring for the filter bar; omit to hide.
filters	`FilterConfig[] \| undefined`	-	Dropdown filters for the filter bar.
onClearFilters	`(() => void) \| undefined`	-
columns*	`ColumnDef<TData, TValue>[]`	-
rows*	`TData[]`	-
pagination	`PaginationConfig \| undefined`	-
onRowClick	`((row: TData) => void) \| undefined`	-
emptyMessage	`string \| undefined`	"No records match the current filters."
isLoading	`boolean \| undefined`	-	Skeletons the metrics strip and table.
error	`DataTableErrorConfig \| null \| undefined`	-	Table error state (widget-owned rendering).
className	`string \| undefined`	-

More Dashboards variants

Dashboard 02 - Analytics

Changelog

dashboard-01

0.1.2

Content sync fix to bring source in line with published registry payload.

0.1.1

Standardize inline comment formatting (em dash → hyphen); no runtime or API change.

0.1.0

Initial release: operational-overview page composed from app-shell, metric-tile, filter-bar, and data-table. Generic over the table row type; one isLoading flag drives skeletons across the whole page.