Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

feat(cli): incident-console page template — frame-first tracker archetype (#3316)

David Petersen3a1b0996c9d5
diff --git a/.changeset/incident-console-template.md b/.changeset/incident-console-template.md
new file mode 100644
index 0000000000..87cb611e86
--- /dev/null
+++ b/.changeset/incident-console-template.md
@@ -0,0 +1,8 @@
+---
+'@astryxdesign/cli': patch
+'@astryxdesign/core': patch
+---
+
+[feat] New `incident-console` page template: an on-call incident response console demonstrating the frame-first tracker archetype — grouped dense incident rows (StatusDot severity, Token state), PowerSearch filtering, status segmented control, and a resizable inspector panel with metadata and timeline. Adds the `Tools - Incident Console` template category.
+
+@thedjpetersen
diff --git a/packages/cli/templates/pages/incident-console/page.tsx b/packages/cli/templates/pages/incident-console/page.tsx
new file mode 100644
index 0000000000..5ea2b85325
--- /dev/null
+++ b/packages/cli/templates/pages/incident-console/page.tsx
@@ -0,0 +1,580 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * Incident Console — an on-call incident response tool.
+ *
+ * Frame-first layout (see `npx astryx docs layout`), distilled from
+ * product-scale apps built with the design system:
+ *
+ * Frame: header | grouped incident rows (fill) | inspector 380 (resizable)
+ *
+ * Responsive contract:
+ * > 1024px header | rows | inspector 380
+ * <= 1024px inspector hidden; rows keep full width
+ *
+ * Container policy (tracker archetype): dense data renders as rows —
+ * edge-to-edge lists grouped by status, zero cards. Status is carried by
+ * StatusDot (severity) and Token (state), not decorative badges.
+ */
+
+import {useMemo, useState, type CSSProperties} from 'react';
+
+import {
+ HStack,
+ Layout,
+ LayoutContent,
+ LayoutHeader,
+ StackItem,
+ VStack,
+} from '@astryxdesign/core/Layout';
+import {ResizeHandle, useResizable} from '@astryxdesign/core/Resizable';
+import {LayoutPanel} from '@astryxdesign/core/Layout';
+import {Heading, Text} from '@astryxdesign/core/Text';
+import {Button} from '@astryxdesign/core/Button';
+import {Icon} from '@astryxdesign/core/Icon';
+import {Divider} from '@astryxdesign/core/Divider';
+import {EmptyState} from '@astryxdesign/core/EmptyState';
+import {List, ListItem} from '@astryxdesign/core/List';
+import {MetadataList, MetadataListItem} from '@astryxdesign/core/MetadataList';
+import {
+ PowerSearch,
+ usePowerSearchConfig,
+} from '@astryxdesign/core/PowerSearch';
+import type {PowerSearchFilter} from '@astryxdesign/core/PowerSearch';
+import {
+ SegmentedControl,
+ SegmentedControlItem,
+} from '@astryxdesign/core/SegmentedControl';
+import {StatusDot} from '@astryxdesign/core/StatusDot';
+import {Timestamp} from '@astryxdesign/core/Timestamp';
+import {Token} from '@astryxdesign/core/Token';
+import {useMediaQuery} from '@astryxdesign/core/hooks';
+import {BellAlertIcon, PlusIcon} from '@heroicons/react/24/outline';
+
+const styles: Record<string, CSSProperties> = {
+ contentFill: {
+ height: '100%',
+ minHeight: 0,
+ },
+ searchRow: {
+ padding: 'var(--spacing-3)',
+ },
+ groupHeader: {
+ padding: 'var(--spacing-2) var(--spacing-3)',
+ backgroundColor: 'var(--color-background-muted)',
+ },
+ rows: {
+ overflowY: 'auto',
+ minHeight: 0,
+ },
+ inspector: {
+ padding: 'var(--spacing-4)',
+ height: '100%',
+ overflowY: 'auto',
+ },
+};
+
+type Severity = 'sev1' | 'sev2' | 'sev3';
+type Status = 'investigating' | 'mitigated' | 'resolved';
+
+interface TimelineEvent {
+ at: string;
+ label: string;
+ detail: string;
+}
+
+interface Incident extends Record<string, unknown> {
+ id: string;
+ title: string;
+ service: string;
+ severity: Severity;
+ status: Status;
+ commander: string;
+ startedAt: string;
+ impact: string;
+ timeline: TimelineEvent[];
+}
+
+// Deterministic fixtures: fixed ISO timestamps, no clocks, no randomness.
+const INCIDENTS: Incident[] = [
+ {
+ id: 'INC-2417',
+ title: 'Checkout API elevated 5xx rate',
+ service: 'checkout-api',
+ severity: 'sev1',
+ status: 'investigating',
+ commander: 'Priya Raman',
+ startedAt: '2026-06-30T21:14:00Z',
+ impact: '12% of checkout requests failing in us-east',
+ timeline: [
+ {
+ at: '2026-06-30T21:14:00Z',
+ label: 'Incident declared',
+ detail: 'Paging monitor: checkout-api 5xx > 5% for 10m',
+ },
+ {
+ at: '2026-06-30T21:19:00Z',
+ label: 'Commander assigned',
+ detail: 'Priya Raman took command',
+ },
+ {
+ at: '2026-06-30T21:31:00Z',
+ label: 'Suspect identified',
+ detail: 'Deploy 8f31c2 correlates with error onset',
+ },
+ ],
+ },
+ {
+ id: 'INC-2416',
+ title: 'Search indexing lag above 30 minutes',
+ service: 'search-indexer',
+ severity: 'sev2',
+ status: 'investigating',
+ commander: 'Marcus Webb',
+ startedAt: '2026-06-30T19:42:00Z',
+ impact: 'New listings not searchable; stale results served',
+ timeline: [
+ {
+ at: '2026-06-30T19:42:00Z',
+ label: 'Incident declared',
+ detail: 'Indexing lag alarm crossed 30m threshold',
+ },
+ {
+ at: '2026-06-30T20:05:00Z',
+ label: 'Mitigation attempted',
+ detail: 'Doubled indexer worker pool; lag still climbing',
+ },
+ ],
+ },
+ {
+ id: 'INC-2415',
+ title: 'Webhook delivery retries exhausting queue',
+ service: 'webhooks',
+ severity: 'sev3',
+ status: 'investigating',
+ commander: 'Ana Duarte',
+ startedAt: '2026-06-30T18:20:00Z',
+ impact: 'Third-party webhook delivery delayed up to 15m',
+ timeline: [
+ {
+ at: '2026-06-30T18:20:00Z',
+ label: 'Incident declared',
+ detail: 'Queue depth alarm on webhook-delivery',
+ },
+ ],
+ },
+ {
+ id: 'INC-2414',
+ title: 'Payments settlement job stalled',
+ service: 'payments',
+ severity: 'sev1',
+ status: 'mitigated',
+ commander: 'Priya Raman',
+ startedAt: '2026-06-30T14:03:00Z',
+ impact: 'Settlement batch delayed; no customer-visible impact',
+ timeline: [
+ {
+ at: '2026-06-30T14:03:00Z',
+ label: 'Incident declared',
+ detail: 'Settlement job heartbeat missed twice',
+ },
+ {
+ at: '2026-06-30T14:26:00Z',
+ label: 'Mitigated',
+ detail: 'Job restarted on standby worker; batch draining',
+ },
+ ],
+ },
+ {
+ id: 'INC-2413',
+ title: 'CDN cache hit ratio degraded in eu-west',
+ service: 'edge-cdn',
+ severity: 'sev2',
+ status: 'mitigated',
+ commander: 'Tom Okafor',
+ startedAt: '2026-06-30T11:47:00Z',
+ impact: 'Origin load 3x baseline; p95 latency +180ms in EU',
+ timeline: [
+ {
+ at: '2026-06-30T11:47:00Z',
+ label: 'Incident declared',
+ detail: 'Cache hit ratio dropped below 80%',
+ },
+ {
+ at: '2026-06-30T12:12:00Z',
+ label: 'Mitigated',
+ detail: 'Rolled back cache-key config change',
+ },
+ ],
+ },
+ {
+ id: 'INC-2412',
+ title: 'Login rate limiting misfiring for SSO users',
+ service: 'auth',
+ severity: 'sev2',
+ status: 'resolved',
+ commander: 'Ana Duarte',
+ startedAt: '2026-06-29T22:31:00Z',
+ impact: 'SSO users intermittently blocked at login',
+ timeline: [
+ {
+ at: '2026-06-29T22:31:00Z',
+ label: 'Incident declared',
+ detail: 'Support surge: SSO login failures',
+ },
+ {
+ at: '2026-06-29T23:02:00Z',
+ label: 'Mitigated',
+ detail: 'Raised limiter threshold for SSO IdP ranges',
+ },
+ {
+ at: '2026-06-30T09:15:00Z',
+ label: 'Resolved',
+ detail: 'Limiter keying fixed to per-user; monitors green 8h',
+ },
+ ],
+ },
+ {
+ id: 'INC-2411',
+ title: 'Notification digests sent twice',
+ service: 'notifications',
+ severity: 'sev3',
+ status: 'resolved',
+ commander: 'Marcus Webb',
+ startedAt: '2026-06-29T08:12:00Z',
+ impact: 'Duplicate daily digest for ~40k users',
+ timeline: [
+ {
+ at: '2026-06-29T08:12:00Z',
+ label: 'Incident declared',
+ detail: 'Duplicate-send reports from support',
+ },
+ {
+ at: '2026-06-29T10:40:00Z',
+ label: 'Resolved',
+ detail: 'Dedup key restored in scheduler; backfill verified',
+ },
+ ],
+ },
+];
+
+const STATUS_ORDER: Status[] = ['investigating', 'mitigated', 'resolved'];
+
+const STATUS_LABEL: Record<Status, string> = {
+ investigating: 'Investigating',
+ mitigated: 'Mitigated',
+ resolved: 'Resolved',
+};
+
+const STATUS_TOKEN_COLOR: Record<Status, 'red' | 'yellow' | 'green'> = {
+ investigating: 'red',
+ mitigated: 'yellow',
+ resolved: 'green',
+};
+
+const SEVERITY_DOT: Record<Severity, 'error' | 'warning' | 'neutral'> = {
+ sev1: 'error',
+ sev2: 'warning',
+ sev3: 'neutral',
+};
+
+const SERVICE_VALUES = [
+ {value: 'checkout-api', label: 'checkout-api'},
+ {value: 'search-indexer', label: 'search-indexer'},
+ {value: 'webhooks', label: 'webhooks'},
+ {value: 'payments', label: 'payments'},
+ {value: 'edge-cdn', label: 'edge-cdn'},
+ {value: 'auth', label: 'auth'},
+ {value: 'notifications', label: 'notifications'},
+];
+
+const SEVERITY_VALUES = [
+ {value: 'sev1', label: 'SEV1'},
+ {value: 'sev2', label: 'SEV2'},
+ {value: 'sev3', label: 'SEV3'},
+];
+
+const fieldDefs = [
+ {key: 'title', type: 'string', label: 'Title'},
+ {key: 'service', type: 'enum', label: 'Service', enumValues: SERVICE_VALUES},
+ {
+ key: 'severity',
+ type: 'enum',
+ label: 'Severity',
+ enumValues: SEVERITY_VALUES,
+ },
+ {key: 'commander', type: 'string', label: 'Commander'},
+] as const;
+
+function IncidentRows({
+ incidents,
+ selectedId,
+ onSelect,
+}: {
+ incidents: Incident[];
+ selectedId: string | null;
+ onSelect: (id: string) => void;
+}) {
+ const groups = STATUS_ORDER.map(status => ({
+ status,
+ items: incidents.filter(incident => incident.status === status),
+ })).filter(group => group.items.length > 0);
+
+ if (groups.length === 0) {
+ return (
+ <EmptyState
+ title="No matching incidents"
+ description="Adjust the status filter or clear search filters."
+ icon={<Icon icon={BellAlertIcon} size="lg" />}
+ />
+ );
+ }
+
+ return (
+ <VStack gap={0}>
+ {groups.map(group => (
+ <VStack gap={0} key={group.status}>
+ <HStack gap={2} vAlign="center" style={styles.groupHeader}>
+ <Text type="label" color="secondary">
+ {STATUS_LABEL[group.status]}
+ </Text>
+ <Text type="supporting" color="secondary">
+ {group.items.length}
+ </Text>
+ </HStack>
+ <List density="compact" hasDividers>
+ {group.items.map(incident => (
+ <ListItem
+ key={incident.id}
+ label={incident.title}
+ description={`${incident.id} · ${incident.service} · ${incident.impact}`}
+ startContent={
+ <StatusDot
+ variant={SEVERITY_DOT[incident.severity]}
+ label={incident.severity.toUpperCase()}
+ isPulsing={
+ incident.severity === 'sev1' &&
+ incident.status === 'investigating'
+ }
+ />
+ }
+ endContent={
+ <HStack gap={3} vAlign="center">
+ <Token
+ size="sm"
+ color={STATUS_TOKEN_COLOR[incident.status]}
+ label={STATUS_LABEL[incident.status]}
+ />
+ <Timestamp
+ value={incident.startedAt}
+ format="relative"
+ color="secondary"
+ />
+ </HStack>
+ }
+ onClick={() => onSelect(incident.id)}
+ isSelected={incident.id === selectedId}
+ />
+ ))}
+ </List>
+ </VStack>
+ ))}
+ </VStack>
+ );
+}
+
+function IncidentInspector({incident}: {incident: Incident}) {
+ const nextAction =
+ incident.status === 'investigating'
+ ? 'Mark mitigated'
+ : incident.status === 'mitigated'
+ ? 'Resolve'
+ : 'Reopen';
+
+ return (
+ <VStack gap={4} style={styles.inspector}>
+ <VStack gap={2}>
+ <HStack gap={2} vAlign="center">
+ <StatusDot
+ variant={SEVERITY_DOT[incident.severity]}
+ label={incident.severity.toUpperCase()}
+ />
+ <Text type="supporting" color="secondary">
+ {incident.id}
+ </Text>
+ <Token
+ size="sm"
+ color={STATUS_TOKEN_COLOR[incident.status]}
+ label={STATUS_LABEL[incident.status]}
+ />
+ </HStack>
+ <Heading level={2}>{incident.title}</Heading>
+ </VStack>
+
+ <HStack gap={2}>
+ <Button label={nextAction} size="sm" />
+ <Button label="Escalate" variant="secondary" size="sm" />
+ </HStack>
+
+ <Divider />
+
+ <MetadataList columns="single" label={{position: 'start', width: 96}}>
+ <MetadataListItem label="Service">
+ <Text type="body">{incident.service}</Text>
+ </MetadataListItem>
+ <MetadataListItem label="Severity">
+ <Text type="body">{incident.severity.toUpperCase()}</Text>
+ </MetadataListItem>
+ <MetadataListItem label="Commander">
+ <Text type="body">{incident.commander}</Text>
+ </MetadataListItem>
+ <MetadataListItem label="Started">
+ <Timestamp value={incident.startedAt} format="date_time" />
+ </MetadataListItem>
+ <MetadataListItem label="Impact">
+ <Text type="body">{incident.impact}</Text>
+ </MetadataListItem>
+ </MetadataList>
+
+ <Divider />
+
+ <VStack gap={2}>
+ <Heading level={3}>Timeline</Heading>
+ <List density="compact">
+ {incident.timeline.map(event => (
+ <ListItem
+ key={`${event.at}-${event.label}`}
+ label={event.label}
+ description={event.detail}
+ endContent={
+ <Timestamp value={event.at} format="time" color="secondary" />
+ }
+ />
+ ))}
+ </List>
+ </VStack>
+ </VStack>
+ );
+}
+
+export default function IncidentConsolePage() {
+ const [statusFilter, setStatusFilter] = useState('all');
+ const [filters, setFilters] = useState<PowerSearchFilter[]>([]);
+ const [selectedId, setSelectedId] = useState<string | null>(INCIDENTS[0].id);
+ const {config, applyFilters} = usePowerSearchConfig(fieldDefs, 'Incidents');
+
+ // Responsive contract: the inspector is hidden at <= 1024px so the row
+ // list keeps its full width (never compress dense rows).
+ const isNarrow = useMediaQuery('(max-width: 1024px)');
+
+ const inspectorPanel = useResizable({
+ defaultSize: 380,
+ minSizePx: 320,
+ maxSizePx: 480,
+ });
+
+ const visible = useMemo(() => {
+ const searched = applyFilters(filters, INCIDENTS);
+ return statusFilter === 'all'
+ ? searched
+ : searched.filter(incident => incident.status === statusFilter);
+ }, [filters, applyFilters, statusFilter]);
+
+ const selected = visible.find(incident => incident.id === selectedId) ?? null;
+
+ const openCount = INCIDENTS.filter(
+ incident => incident.status === 'investigating',
+ ).length;
+
+ return (
+ <Layout
+ height="fill"
+ header={
+ <LayoutHeader hasDivider>
+ <HStack gap={3} vAlign="center">
+ <StackItem size="fill">
+ <HStack gap={2} vAlign="center">
+ <Heading level={1}>Incidents</Heading>
+ <Text type="supporting" color="secondary">
+ {openCount} investigating
+ </Text>
+ </HStack>
+ </StackItem>
+ <SegmentedControl
+ label="Filter by status"
+ value={statusFilter}
+ onChange={setStatusFilter}
+ size="sm">
+ <SegmentedControlItem label="All" value="all" />
+ <SegmentedControlItem
+ label="Investigating"
+ value="investigating"
+ />
+ <SegmentedControlItem label="Mitigated" value="mitigated" />
+ <SegmentedControlItem label="Resolved" value="resolved" />
+ </SegmentedControl>
+ <Button
+ label="Declare incident"
+ icon={<Icon icon={PlusIcon} size="sm" />}
+ size="sm"
+ />
+ </HStack>
+ </LayoutHeader>
+ }
+ content={
+ <LayoutContent padding={0}>
+ <VStack gap={0} style={styles.contentFill}>
+ <HStack style={styles.searchRow}>
+ <StackItem size="fill">
+ <PowerSearch
+ config={config}
+ filters={filters}
+ onChange={newFilters => setFilters([...newFilters])}
+ placeholder="Search incidents..."
+ resultCount={visible.length}
+ />
+ </StackItem>
+ </HStack>
+ <StackItem size="fill" style={styles.rows}>
+ <IncidentRows
+ incidents={visible}
+ selectedId={selected?.id ?? null}
+ onSelect={setSelectedId}
+ />
+ </StackItem>
+ </VStack>
+ </LayoutContent>
+ }
+ end={
+ isNarrow ? undefined : (
+ <>
+ <ResizeHandle
+ direction="horizontal"
+ hasDivider
+ isAlwaysVisible={false}
+ resizable={inspectorPanel.props}
+ label="Resize inspector"
+ />
+ <LayoutPanel
+ width={inspectorPanel.size}
+ padding={0}
+ label="Incident details">
+ {selected ? (
+ <IncidentInspector incident={selected} />
+ ) : (
+ <EmptyState
+ title="No incident selected"
+ description="Select an incident to see details and timeline."
+ icon={<Icon icon={BellAlertIcon} size="lg" />}
+ isCompact
+ />
+ )}
+ </LayoutPanel>
+ </>
+ )
+ }
+ />
+ );
+}
diff --git a/packages/cli/templates/pages/incident-console/template.doc.mjs b/packages/cli/templates/pages/incident-console/template.doc.mjs
new file mode 100644
index 0000000000..0d5b8d205c
--- /dev/null
+++ b/packages/cli/templates/pages/incident-console/template.doc.mjs
@@ -0,0 +1,12 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/** @type {import('../../../../core/src/docs-types').TemplateDoc} */
+export const doc = {
+ type: 'page',
+ name: 'Incident Console',
+ displayName: 'Incident Console',
+ description:
+ 'On-call incident response console: grouped dense incident rows with severity dots, PowerSearch filtering, status segmented control, and a resizable inspector panel with metadata and timeline. Frame-first tracker archetype — rows, not cards.',
+ isReady: false,
+ category: 'Tools - Incident Console',
+};
diff --git a/packages/core/src/docs-types.ts b/packages/core/src/docs-types.ts
index c397f4fbc1..6fa9ad416e 100644
--- a/packages/core/src/docs-types.ts
+++ b/packages/core/src/docs-types.ts
@@ -859,6 +859,7 @@ export type TemplateCategory =
| 'Tools - File Explorer'
| 'Tools - Page Editor'
| 'Tools - IDE'
+ | 'Tools - Incident Console'
| 'Tools - Kanban Board'
| 'Tools - Notebook/Report Page'
| 'Tools - Diff Compare Viewer'