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.mdnew file mode 100644index 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.++@thedjpetersendiff --git a/packages/cli/templates/pages/incident-console/page.tsx b/packages/cli/templates/pages/incident-console/page.tsxnew file mode 100644index 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.mjsnew file mode 100644index 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.tsindex 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'