Skip to main content

web ui patterns survey

This page records a survey of other interfaces, and what corral took from each one. It exists so the next person does not repeat the search, and so a pattern that corral rejects stays rejected for a stated reason.

Each row names the pattern, where we saw it, and what corral does. "Added" rows name the check in scripts/ui-smoke.mjs that holds the behaviour in place.

How we checked each one​

Not every row rests on the same quality of evidence, so the table below says which. Read a "secondary" row as weaker. The pattern comes from a write-up about the product, not from the product or its own documentation.

InterfaceEvidence
KubeStellarSource. We cloned kubestellar/ui and read plugin.yml, PluginAPI.ts and the plugin types.
W3C APGPrimary. The pattern pages themselves.
WCAGPrimary. The success criteria.
Proxmox VESource. We cloned pve-manager and read www/manager6/, and the GUI page of its documentation. See the licence note below.
VS CodePrimary. The keybindings and tips pages.
GrafanaPrimary. The panel and dashboard documentation.
vSpherePrimary for the failure: a Broadcom support article about a lost pane.
Nutanix PrismSecondary, and it cannot be better. See the note below.
LinearSecondary. Write-ups about its palette and shortcuts.
k9sSecondary. Comparison articles that quote its :po prefixes.
HarvesterSecondary. The Harvester and Rancher documentation, and its UI extension's architecture page.
CockpitPrimary for the list behaviour: the Fedora and Rocky guides to the Machines page.
PortainerSecondary. Tutorials and reviews, because the project publishes no UI guide.
RancherSecondary. Its own documentation for the Virtualization Management area.
Data-table conventionsSecondary. A 2026 design guide, not a standard.

A secondary row is still useful, because the pattern repeats across products. Two sources had to agree before we took a pattern from them.

Reading pve-manager, and not copying it​

Proxmox VE is the closest peer in this list, and it publishes its code. So we cloned pve-manager and read the ExtJS UI under www/manager6/. Before that, the documentation was all we had used, which is a thin way to study the one product we can read.

pve-manager is AGPL-3.0 and corral is Apache-2.0. AGPL code cannot move into an Apache-2.0 project, so we take decisions from it and no code. Each row that rests on the source says which decision, and the shape corral used instead.

Why Prism stays a secondary source​

We searched for better evidence. There is none to find.

  • Prism has no public source. Nutanix publishes infrastructure tooling, a Terraform provider and an Ansible collection. It publishes no UI library and no design system. Every repository named "Prism UI" on GitHub belongs to an unrelated project.
  • The vendor's documentation needs a login. portal.nutanix.com keeps the Prism Central guide behind authentication. We therefore have its text only where a search result quoted it. Any row that rests on that says so.
  • We have no screenshots. The portal gates its images, and the Nutanix Bible's figures did not come through. No row below rests on a picture of the product.

What we did read in full is the Nutanix Bible's navigation chapter, which documents the keyboard model. That chapter is where the Prism rows come from.

The interfaces​

InterfaceWhy it is here
Proxmox VEThe closest peer, and the one whose code we can read.
HarvesterThe closest peer of all: a web console over KubeVirt.
CockpitThe same guests, managed from one host.
PortainerThe container console that corral's CT views answer to.
RancherOne console over both guests and workloads.
vSphere Web ClientThe same shape, and a documented failure corral can avoid.
Nutanix PrismSearch-first navigation, and a keyboard model written down.
VS CodeThe reference for a command palette and a breadcrumb.
LinearA dense, keyboard-first list UI.
GrafanaDashboards of draggable panels, and Ctrl+K.
k9sTyped prefixes that jump between resource kinds.
KubeStellarA plugin that declares its own place in the UI.
W3C APGThe behaviour contract for splitter, combobox and tabs.
Data-table conventionsDensity, keyboard movement and focus in a grid.
WCAGSkip links, status messages, reduced motion.

Layout​

PatternSeen incorral
Tree, content, dock, headerProxmox, vSpherePresent before this work.
Only the content pane scrollsProxmox, vSphereAdded. The window scrolled, which carried the header and tree away. workspace-layout
Resizable tree and dockProxmoxAdded. One splitter primitive. workspace-layout
Hide a pane completelyProxmoxAdded. The separator stays, because it owns the key that restores the pane. workspace-layout
Dockable, movable panelsvSphere Web ClientDeclined. Two resizable edges and a tab strip cover the need. Free docking is a large build with little gain here.
The URL addresses what is on screenProxmox (StateProvider, read in the source)Added. The page had one address, so nobody could link to a guest and the back button did nothing. deep-link
Navigation goes in the URL, layout stays localProxmox (its hslist is view, resource and tab, and nothing else)Added. A link says where you are. Pane widths are how you like to work, and sending those to somebody else would be rude. deep-link
Back and forward walk the UIProxmoxAdded. deep-link
The list's filters and sort in the address—Added, past the reference: Proxmox addresses the resource, not the grid. A filtered list became something to send. grid-address
A filter keystroke is not a history entry—Added with it. A change to the place pushes; a change to the grid alone replaces. grid-address
A URL short enough to pasteProxmox (a positional list against a dictionary of every tab name)Declined. That needs a central table naming each tab, which is the shape the capability registry just removed. corral uses readable keys, and accepts a longer address.
Typing the name to confirm a removalProxmox (ConfirmRemoveDialog, read in the source)Added. Deleting a guest takes its disks, and it was one confirm(): a box with its default button already focused, so a stray Enter after a bulk selection destroyed guests and their storage. confirm-destroy
A plain confirm for everything elseProxmox (only dangerous removals get the field)Kept. A dialog that always demands typing teaches people to type without reading.
Name each failure, not a countProxmox (its bulk actions return a task, and the task log names each guest)Added. "2 failed" told the operator nothing to act on, in a toast that was gone before they could ask. bulk-failures
Reset the layoutDashboard widgets, and vSphere by its absenceAdded. vSphere let admins lose a pane for good. reset-layout
PatternSeen incorral
Several groupings of one fleetProxmox (Server, Storage, Pool, Folder)Added Storage View. Server, Namespace and Pool existed. storage-view
Breadcrumb to the parentVS Code, vSphereAdded. breadcrumb
Search before menusPrism, GrafanaPalette existed. Added a visible way in. palette-reach
Single-key jumpsPrism, LinearPresent (g d, c, s). Added hints, because nothing told anyone. palette-keys
A diagram of the fleetPrism (the D in its overview / diagram / table switch)Added. A card per node with its guests inside, coloured by state and summed at the top. Guests drag between nodes to migrate, through the tree's own drop rule. Cards reflow instead of a node-and-edge drawing, which stops being readable at fleet sizes. g t. topology
The view switch has a keyPrism (O/D/T, page-aware)Added. Four views of the same fleet, reachable by mouse alone until now. v walks them. palette-filters
A list, then a detail screen with its tools along the topPortainer, CockpitPresent.
A wizard behind the list's Create actionHarvesterPresent.
Status barVS CodeDeclined. The dock already holds the state a status bar would carry.

The command palette​

PatternSeen incorral
Ctrl/Cmd+KVS Code, Grafana, LinearPresent.
A visible triggerEvery touch UIAdded. On a phone the palette could not open at all. palette-reach
Typed prefix narrows the listk9s (:po), VS Code Quick OpenAdded. palette-scope
field=value in the queryPrism (vm alerts severity=critical)Added. node, namespace, status, backend and tag. A name match cannot tell a node from a guest called after one, and an unknown field matches nothing rather than look answered. palette-filters
The palette teaches its shortcutsVS Code, LinearAdded. palette-keys
Recent entries firstVS Code, LinearPresent.
Result count announcedAPG comboboxAdded. palette-reach

The data grid​

PatternSeen incorral
Sort, reorder, hide, resize columnsGrafana, every consolePresent.
Saved viewsGrafanaPresent.
Sticky headerData-table conventionsPresent. The survey expected a gap and found none.
Density as named modesData-table conventionsAdded. Three modes, kept per grid. grid-density
Arrow keys move between rowsData-table conventionsAdded. Tab belongs to the controls in a row. grid-keys
Quiet hover, loud focus ringData-table conventionsAdded with density.
One action on each row, following the row's stateCockpitAdded. Every action needed a checkbox and the bulk bar, or opening the guest. grid-row-actions
The rest of the actions one menu awayCockpit, PortainerAdded with the row action, from the set the right-click already offered. grid-row-actions
A control in a row keeps its own keysAPG practiceAdded. Space on a row's checkbox opened the guest instead of selecting it. grid-row-actions
Act on many rows from the listPortainerPresent. bulk-select
A colour and a word for statePortainer, CockpitPresent.
Node placement in the listRancherPresent.
Live usage bars in the rowsCockpitDeclined. The CPU and Mem columns hold what a guest was given. A bar reads as a share of something in use, so it would state a number corral does not have.

State and redraw​

PatternSeen incorral
Update rows in placeEvery live consoleAdded. The poll rebuilt everything every 5 s. tree-reconcile, grid-reconcile
Keep a live console across a redrawProxmox, vSphereAdded. The page used to freeze instead. console-stays-live, multiview-stays-live
Hold off during a gestureGeneralAdded. interaction-guard
Say whether the server refused or never answeredProxmox (getResponseErrorMessage returns "Connection error" when there is no status)Added. fetch rejects with "Failed to fetch", which says nothing about corral being down. api-errors
Never show an empty errorProxmox (its message always carries the status)Added. statusText is the HTTP reason phrase and HTTP/2 has none, so behind any proxy speaking h2 a non-JSON failure threw a blank message. api-errors
Focus before the scroll, and without moving the viewProxmox (an override on its grid view, for this exact order)Added. corral restored the scroll and focused after, and focusing scrolls the element into view, so a render that moved the focused row threw the position away.
One poll at a timeProxmox (UpdateStore schedules the next load from the last load's callback)Added. A fixed 5-second timer over an asynchronous refresh sent a second request before the first came back. Measured: two in flight against a slow endpoint, now one. poll-backoff
A slow server is polled lessProxmox (its interval is the base plus twice the last load's runtime)Added, with the same arithmetic. Nobody tunes it, and a struggling server gets room. poll-backoff
A refresh asked for during a poll is not lost—Added with the guard. The callers that force a refresh have just changed something and have to see it.
Poll nothing while nobody can see the page—Added, one step past the reference: Proxmox polls a hidden tab too. Every poller in the UI stops, and each catches up the moment the page is shown. quiet-when-unseen
Report a repeated failure once—Added. A server that is down fails every poll, and a toast each time buried the page under one sentence. quiet-when-unseen
A missing identity is not a missing cluster—Added. corral authorises against the identity the Tailscale ingress passes on, and has no login of its own. A 401 on first load fell into the no-cluster screen and told the operator to fix kubectl. It now says what is wrong, and the page recovers by itself when the identity returns. quiet-when-unseen
Land on the nearest surviving parentProxmox (ResourceTree walks the parent chain)Added. A deleted or migrated guest dropped you at the datacenter, the furthest place from where you were. vanished-selection
Compare only the fields that are drawnProxmox (changedFields, and it mutates the record in place)Declined, and measured first. corral rebuilds a row when any field of the guest changes, because its handlers close over the guest object and a reused node must not hold an old one. That is only safe while the fleet payload carries nothing volatile, which it does not: two polls of /api/vms are byte-identical. tree-reconcile is what guards it, because a volatile field would churn every signature and the kept-row count would drop.

Customisation​

PatternSeen incorral
Draggable, resizable widgetsGrafanaPresent.
Layout kept per browserGrafana, ProxmoxPresent, and extended to the workspace.
Light and darkMost modern UIsAdded. Follows the desktop. colour-scheme
Accent colourProxmox themingPresent, through /api/theme.
Several dashboards for one scopePrism (Manage Dashboard)Added. A scope had exactly one, so watching capacity and chasing a failure meant rebuilding the same screen twice. The arrangement and the density belong to the dashboard. named-dashboards
Density for the dashboard, not only for a tablePrism (its Data Density setting)Added. Three modes under the data grid's own names, kept per dashboard, and Reset layout restores them. dash-density

Small screens​

PatternSeen incorral
Sidebar becomes a drawerMost responsive appsPresent.
One column for a widget gridGrafana mobileAdded. Three columns at 420px clipped every figure. dashboard-on-a-phone
Icons replace labels on a toolbarMost mobile appsAdded. toolbar-on-a-phone
Rare actions move to an overflow menuMost mobile appsAdded. toolbar-on-a-phone

Access without a mouse​

PatternSeen incorral
Splitter keys, and Enter to collapseAPG window splitterAdded. The pattern needs Enter. workspace-layout
Combobox semantics in the paletteAPG comboboxPresent.
Tabs with a roving tabindexAPG tabsAdded with the dock tabs. dock-tabs
Skip linkWCAG 2.4.1Added. The tree rows made the walk longer. reachable
Status messages announcedWCAG 4.1.3Added. Toasts were silent. reachable
Reduced motionWCAG 2.3.3Added. reachable
A single key opens a panelPrism (P tasks, A alerts)Added. The dock panels answered to the mouse and to Tab, and to nothing else. The letters are corral's own, after its panel names. dock-keys
The same key dismisses itGeneralAdded with the key, so one key does both. dock-keys
Arrow keys move through a menuPrismPresent.
A single key is a letter inside a fieldPrism, and every app with single-key shortcutsPresent, and the new keys obey it. dock-keys

Extensibility​

PatternSeen incorral
A marketplace of pluginsKubeStellarPresent.
Permissions a plugin declaresKubeStellarPresent.
The host places a contribution, rather than naming itKubeStellarAdded. A capability registers what it adds; core draws it. host-power
A plugin declares its place in the UIKubeStellarProposed for the plugin contract. Stage 0 is built. See RFC-0002.
A plugin ships code the page runsKubeStellar (WASM, plugin-component.js)Declined. corral embeds its UI and has no build step. Script from a marketplace could read the session and call any API.
Documented extension points—Added. See the extension points.

What the survey still leaves open​

  • A Storage content screen. Storage View reads the catalogue. To add, remove or clean up images needs backend work.

  • Dock panels beyond Tasks and Events. #350 also asks for a cluster log. corral's task log already is that log, so a second tab would show one thing twice.

  • Plugin UI contributions, stages 1 and 2. RFC-0002 holds the design. It covers the ui metadata section and the typed documents. It also covers a marketplace plugin whose only purpose is a screen. A maintainer owns that call, because it changes the boundary in ADR-0007.

    Stage 0 is built. ui/capabilities.js holds a registry that accepts entries at run time, and host-power registers with it. Core keeps one line about that capability: the import that loads its module. See the extension points for the hooks.