Agent-Up design system
One design schema
Every app, every docs appearance, every post and everything else uses the same design schema.
I added apps/storefront/PromoBanner2.tsx so the storefront can show the weekly harbor special. It is uncommitted in the working tree.
[install] npm install Storefront listening on WEB_PORT
Assembled screens
One central definition.
Each screen is defined centrally and itself assembled from central component definitions.
Applications
Each tab is a running application surface. Desktop opens the allocated HTTP port; Mobile lists Apps in the workspace bottom bar.
Components on this screen · 32
Screen
The window is a column of catalog chrome plus a body. Capture size is a persist concern, not a second theme.
Title bar
Keep the mark small. Never add glow around the window. Connected chrome carries sidebar, reload, and the Server badge.
Screen body
Desktop body is the rail beside the main column. Mobile does not use this grid.
Screen rail
Rail layout sits on au-rail paint. Do not invent a screenshot-only sidebar.
Rail heading
The rail names the list, then add and collapse. Those controls stay compact; they are not a primary CTA.
Workspace row
Idle rows are transparent and hover with the neutral state layer. The selected checkout takes an accent tint plus a 2px accent rule on its leading edge, never a saturated fill. Start, identity, and delete are the same controls on Desktop and Mobile. A running workspace shows stop, not play.
Selected workspace · selected:0
The open checkout takes the accent tint plus a 2px accent rule.
Screen main
Tabs, subtabs, then a pane. The pane is au-pane, not a full-bleed slab.
Screen tab strip
Host for au-app-tab. The strip is structure; selection stays on the tab.
Workspace tabs
Overview, Agent, and Git sit with the application tabs. Overview is selected. A hairline separates workspace chrome from running apps.
Agent tab selected · selected:1
The live ACP session is the primary selection when Agent is open.
Git tab selected · selected:2
Working-tree review is the primary selection when Git is open.
Application tab selected · selected:3
Storefront is the primary selection when the running app is open.
Screen subtab strip
Host for au-subtab. Secondary selection stays neutral.
Port and tool tabs
The second row is secondary to the application tabs, so its selected state stays neutral: the active state layer, not the accent. Desktop builds the allocated port, then Console, Diagnostics, Metrics and Database.
Console subtab selected · selected:1
Console is still a secondary selection. It uses the active layer, not the accent underline.
Diagnostics subtab selected · selected:2
The audit trail for the selected application sits beside Console.
Metrics subtab selected · selected:3
CPU, memory and request duration for the selected application.
Database subtab selected · selected:4
The database explorer for the selected application.
Screen toolbar
Host for the address bar under application subtabs. Empty when the scene has no browser chrome.
Address bar
Monospace URL, compact height, neutral field. Focus stays blue.
Screen pane slot
Working region. Pair with au-pane or a catalog surface; do not force a second screenshot shell.
Storefront pane
Storefront
Harbor Shop
Featured goods from the harbor catalog.
Stoneware, fog glaze
$18
Waxed canvas, brass snap
$32
Brass shade, linen cord
$54
Recent orders
The application surface is catalog cards and buttons, not a restyled screenshot shell. Prices and the primary cart action carry green because they are meaning.
Top bar
The PWA and native chrome stay on the canonical canvas with a subtle divider, not a floating card. A screen names the title it shows and which controls it carries; AppNavBar takes the same title as a prop.
Git top bar · title=Git; parts=menu title
Inner Git pages keep the hamburger and the Git title.
Back bar · title=Changes; parts=back title
Inner Git Review and History return through the nav-bar back control.
History back bar · title=History; parts=back title
History is an inner page. Back returns to Git.
Agents top bar · parts=menu
The picker chrome is the hamburger only until a session is open.
Settings top bar · title=Settings; parts=menu title reload
Settings keeps Reload next to the title.
Application bar · title=Storefront; parts=back title
HTTP application pages keep Back and the application title. Validation lives in the dock under the webview.
Mobile body
Scrolls between the top bar and the tab bar.
Application list
Mobile Apps lists running applications under the workspace identity. Health is a LED plus label.
Bottom tabs
Workspace chrome is Apps, Git, Agents, then Settings. Each tab has a 20px outline icon plus label. Selected uses the catalog subtab selected state, which is neutral.
Git bottom tab · selected:1
Git is the selected workspace tab.
Agents bottom tab · selected:2
Agents is the selected workspace tab.
Settings bottom tab · selected:3
Settings is the selected workspace tab.
Typography
AI-assisted development workspaces
Workspaces
See the runtime. Trust the review.
Product screens use page title, not the marketing display size. Monospace is reserved for commands, paths, ports, logs, and diffs.
agent-up start · localhost:11200 · feat/checkoutApplications use platform sans-serif at these roles. Authored web uses Inter.
Buttons
Primary fill is the only bright green action. Danger is red, never green.
Badges and status
Combine color with a label. Do not use a green dot alone.
Window controls
Close hover is danger red. Every other chrome hover uses the neutral state layer, never the accent.
Close control
Only the close control uses danger on hover.
Title tools
Sidebar and reload sit in the chrome so the workspace rail stays dedicated to workspaces.
Wordmark
The product name in chrome is 13px bold, not a marketing title.
Workspace name
The title lives inside the workspace row. Do not restyle it per surface.
Workspace branch
The subtitle stays muted inside the same row.
Remove workspace
Delete stays quiet until hover, then uses danger text.
Lifecycle controls
Start and stop are compact icon actions, not a second primary CTA.
Browser chrome button
Back, forward, and reload use the compact raised icon treatment.
Lockup
Safe space is at least one internal stroke. No outer glow.
Foundations
Tokens and voice
The shared ground both interfaces stand on. Components are listed with the screens that use them, above.
Canvas
--au-color-canvas#0a0b0c
Window, page, and PWA ground.
Surface
--au-color-surface#121416
Panels without fake elevation.
Subtle border
--au-color-border-subtle#ffffff14
Default structure. Never green by default.
Primary text
--au-color-text-primary#f5fbf7
Titles and important labels.
Action
--au-color-accent#00b850
Primary action, not decoration.
Healthy
--au-color-status-healthy#22c55e
Healthy state with a label.
Danger
--au-color-status-danger#d84f4f
Failure and destructive action.
Focus
--au-color-focus#00a8e8
Keyboard focus, distinct from success.
Category
Local runtime control plane for AI-assisted development.
Promise
Run, inspect, and review parallel development workspaces without process, port, infrastructure, or browser-state collisions.
Boundary
Agent-Up complements editors, coding agents, Git, Docker, and application frameworks; it does not replace them.
Shipped in the current public development-preview build.
Usable, but its contract or experience may change.
Incomplete, opt-in, or not supported on every platform.
Product direction only; not available to users.