Skip to main content

Component Library

Reusable React components in the Web UI.

DataTable​

A generic table component that renders data from a column definition:

type Column<T> = {
key: string
header: string
render: (item: T) => React.ReactNode
headerClassName?: string
cellClassName?: string
}

<DataTable
columns={pathColumns}
data={config.permissions.paths}
rowKey={(r) => r.id}
emptyMessage="No path rules configured."
/>

Toggle​

An on/off switch:

<Toggle
checked={user.enabled}
onChange={(checked) => handleToggleUser(user)}
label="Enable user"
/>

Badge​

Colored status indicators:

<Badge variant="health" value="healthy" label="Connected" showIcon />
<Badge variant="result" value="allowed" />
<Badge variant="access" value="write" />
<Badge variant="status" value="loaded" label="Config loaded" />

Variants: health, result, access, status. Each maps values to predefined colors.

AccessToggles / CommandToggles​

Toggle groups for permission levels:

<AccessToggles value="read" onChange={(level) => handleToggle(rule.id, level)} />
// Renders: [None] [Read] [Write] with current level highlighted

<CommandToggles value="active" onChange={(level) => handleToggle(rule.id, level)} />
// Renders: [None] [Active]

FolderTree​

Recursive folder browser with access level indicators:

<FolderTree
folders={visibleFolders}
disabled={toggling}
onToggle={(path, access) => handleCascadeToggle(path, access)}
/>

Each node shows the folder name and a colored access level indicator (red=none, blue=read, green=write). Clicking a node toggles its access level and cascades to children.

Consistent page header:

<PageHeader
title="Ubuntu Server"
backHref="/"
actions={<button onClick={handleScan}>Scan folders</button>}
/>

Dialog overlay:

<Modal open={showDialog} onClose={() => setShowDialog(false)} title="Add Path Rule">
<form>...</form>
</Modal>

EmptyState​

Placeholder for empty lists:

<EmptyState
icon={<Shield size={40} />}
title="No users configured"
description="Agents will appear after their first MCP request."
action={<button onClick={add}>Add your first user</button>}
/>

StatsCards​

Recharts-based usage analytics on the dashboard. Displays request volumes over time, by server, and by user.