Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
client/src/components/ui/ — shared UI primitives
Presentational building blocks with no domain knowledge. Grep this catalog before
hand-rolling chrome — nearly every primitive here exists because the same markup had
already been copy-pasted across three-to-ten surfaces and drifted (usually on
accessibility). Feature-specific components live under their own feature directory
(components/pipeline/, components/meatspace/, …), not here.
| Component | What it's for |
|---|---|
ActionActivityBar |
Thin indeterminate bar at the top of the app while a tap-started request (services/actionFeedback.js) runs past 300ms. Mounted once in Layout. |
AutoSizeTextarea |
Controlled <textarea> that grows to fit its content — no internal scroll, no hand-resize. |
Banner |
Toned alert block (icon + content + actions) for warnings, errors, and info callouts. |
SettingsLoadError |
Inline "failed to load saved settings" banner with Retry; pair with a disabled Save so defaults are never written over stored values. |
BeatPulse |
Metronome dot row — one dot per beat of the bar, the current one lit. |
CollapsibleListItem |
Successful-delete row collapse with reduced-motion support and focus transfer; set removing, then filter local state in onExited. Owns row spacing. |
CollapsibleSection |
Disclosure section header — chevron, leading icon, collapsed summary, aria-expanded/aria-controls; keepMounted hides the body instead of unmounting it. |
CollapsibleText |
Collapsed content preview with a show-more/less toggle — line-clamped text, or children capped by maxHeight when line-clamp can't (rendered markdown). |
ConfirmButtonPair |
Compact inline confirm/cancel pair for a destructive action in a dense control row. |
ConnectionStatusDot |
Live-transport status dot — coloured by connection state, with a caption and the state word. |
CopyableId |
Click-to-copy record-id badge — short prefix shown, full id copied. |
diffRuns |
Renders { text, changed } runs from diffWords as highlighted nodes (shared by the diff views). |
FilePickerButton |
Opens the OS file picker, styled as a button or as a whole drop target. |
FormField |
Accessible config-field wrapper — generates an id and wires <label htmlFor> to the input; compact preserves dense editor-label styling. |
HunkDiff |
Hunked side-by-side diff for long texts, with unchanged runs collapsed. |
ImageThumb |
List-card thumbnail with an icon fallback when the ref is missing or 404s. |
InfiniteScrollFooter |
Shared scroll sentinel with loading, retry, end state and accessible manual Load more; pair with usePagedCollection. |
InfoTooltip |
Focusable info/help tooltip — hover, keyboard focus, or tap; opaque body portal with viewport-clamped numeric width (default 224), start/center/end alignment, keyboard scrolling, and Esc dismissal. |
InlineConfirmRow |
Inline "question + confirm + cancel" row — PortOS's preferred alternative to window.confirm. |
InlineDiff |
Stacked word-level diff — old row (red removals) over new row (green additions). |
ListLoadError |
Inline failed-read row (message + Retry) for a picker or list section fed by useListResource; render on state === 'error' so a failed load never reads as an empty list. |
LoadFailedState |
Alert shown when a read failed (title, hint, Retry) so a failed load never renders as an empty-list sentence. |
Kbd |
Keycap for rendering a keyboard key in help/cheatsheet UI. |
Modal |
Shared modal chrome — backdrop, Esc handling, click-outside. |
OverflowMenu |
"…" menu that demotes rare or destructive row actions out of the visible control set. |
PageSkeleton |
Full-page loading skeleton that reserves the loaded layout so the first paint doesn't reflow. |
Pill |
Inline label badge — semantic tone, optional icon, sm/xs sizes. |
ProcessLogLines |
Renders a PM2 process's log lines (the body of a log pane) from useProcessLogs status, with an unavailable notice + Retry for ended streams; also exports LogStreamBadge. |
ProcessLogModal |
Self-contained viewer for a PM2 process's system log. |
ProgressBar |
Horizontal progress meter — percent (or null for indeterminate), semantic tone, and the ARIA trio with an accessible name from label. |
ProseEditor |
Prose-writing textarea — serif face, relaxed leading, spellcheck. Markdown string in/out. |
ProvenanceChip |
Chip + popover showing where a generated value came from. |
SideBySideDiff |
Columnar word-level diff — old left, new right. |
RecordStatusLine |
One status row under a multi-stage record's title — stage in words (toned for waiting / failed), short facts, and a single next-action button (the Music Video status-line pattern, #9858). |
Skeleton |
Loading-placeholder primitives (SkeletonBlock / Lines / Card / Rows / Region) — what PageSkeleton is built from, and what a sub-region loader should reserve its shape with instead of a bare spinner. |
TabPills |
Shared tab nav — underline / pills / filter (toggle chips) families; mobileCompact collapses it to an icon row under sm (labelled <select> when a tab has no icon). |
Toast |
Toast notification system (toast(), .success(), .error(), .loading(), <Toaster />). |
ToggleChip |
Checkbox styled as a pill — the "pick some of these" affordance. |
ToolUseWarning |
The "this model can't call tools" warning every agent/model picker shows. |
UnsavedChangesConfirm |
The discard confirm every useUnsavedChangesGuard consumer renders from blocked. |
There is no index.js barrel here — components are imported by path
(import ProgressBar from '../ui/ProgressBar'), matching the rest of components/. The
barrel + README rule in the root AGENTS.md covers lib/, hooks/, utils/, and
services/; this catalog exists for discovery only. Adding a primitive here means
adding its row above — a catalog nobody updates is the reason six copies of the
progress meter existed in the first place.