Skip to main content

Agent-Up design system

One design schema

Every app, every docs appearance, every post and everything else uses the same design schema.

Server online Starting Failed MCP connected
Harbor Shop main
HEAD 369-mobile origin/main v3.47.0
02.10.26 14:33
02.10.26 11:04
01.10.26 19:41
01.10.26 08:12
30.09.26 16:20
22.09.26 09:18
22.09.26 07:30
feat(storefront): add the weekly promo banner Demo
HEAD 369-mobile origin/main v3.47.0
Add a promo banner to the storefront.
Codex

I added apps/storefront/PromoBanner2.tsx so the storefront can show the weekly harbor special. It is uncommitted in the working tree.

Changes
apps
storefront
ProductGrid.tsx M
PromoBanner.tsx +
PromoBanner2.tsx +
api
orders.ts M
[install] npm install
Storefront listening on WEB_PORT
Time · Kind · Message
12:01 · process · listening on 11200
12:02 · browser · net::ERR_CONNECTION_REFUSED
p95128 ms

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.

Desktop
Mobile

Components on this screen · 32

Screen

.au-screen · Border

The window is a column of catalog chrome plus a body. Capture size is a persist concern, not a second theme.

Title bar

.au-chrome · Border

SERVER ONLINE Agent-Up − □ ×

Keep the mark small. Never add glow around the window. Connected chrome carries sidebar, reload, and the Server badge.

Screen body

.au-screen-body · Border

Desktop body is the rail beside the main column. Mobile does not use this grid.

Screen rail

.au-screen-rail · Border

Rail layout sits on au-rail paint. Do not invent a screenshot-only sidebar.

Rail heading

.au-workspace-head · Border

Workspaces

The rail names the list, then add and collapse. Those controls stay compact; they are not a primary CTA.

Workspace row

.au-workspace · Border · Desktop wsEntry

Harbor Shop main

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

Harbor Shop main

The open checkout takes the accent tint plus a 2px accent rule.

Screen main

.au-screen-main · Border

Tabs, subtabs, then a pane. The pane is au-pane, not a full-bleed slab.

Screen tab strip

.au-screen-tabs · Border

Host for au-app-tab. The strip is structure; selection stays on the tab.

Workspace tabs

.au-app-tab · Border

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

.au-screen-subtabs · Border

Host for au-subtab. Secondary selection stays neutral.

Port and tool tabs

.au-subtab · Border · Desktop subTab

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

.au-screen-toolbar · Border

Host for the address bar under application subtabs. Empty when the scene has no browser chrome.

Address bar

.au-address-bar · TextBox · Desktop addressBar

Monospace URL, compact height, neutral field. Focus stays blue.

Screen pane slot

.au-screen-pane · Border

Working region. Pair with au-pane or a catalog surface; do not force a second screenshot shell.

Storefront pane

.au-storefront · Border

Storefront

Harbor Shop

Featured goods from the harbor catalog.

Harbor Mug

Stoneware, fog glaze

$18

Canvas Tote

Waxed canvas, brass snap

$32

Chart Lamp

Brass shade, linen cord

$54

Cart
Harbor Mug × 1$18
Canvas Tote × 1$32
Total$50

Recent orders

Harbor Mug × 1$18

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

.au-mobile-bar · Border

Harbor Shop

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

Git

Inner Git pages keep the hamburger and the Git title.

Back bar · title=Changes; parts=back title

‹ Changes

Inner Git Review and History return through the nav-bar back control.

History back bar · title=History; parts=back title

‹ History

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

Settings keeps Reload next to the title.

Application bar · title=Storefront; parts=back title

‹ Storefront

HTTP application pages keep Back and the application title. Validation lives in the dock under the webview.

Mobile body

.au-screen-mobile-body · Border

Scrolls between the top bar and the tab bar.

Application list

.au-app-list · Border

Harbor Shop Healthy
Applications
Storefront Running
Orders API Running
Inventory Running

Mobile Apps lists running applications under the workspace identity. Health is a LED plus label.

Bottom tabs

.au-mobile-tab-bar · Border

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

.au-heading · TextBlock

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/checkout

Applications use platform sans-serif at these roles. Authored web uses Inter.

Buttons

.au-button · Button

Primary fill is the only bright green action. Danger is red, never green.

Badges and status

.au-badge · Border

Server online Starting Failed MCP connected

Combine color with a label. Do not use a green dot alone.

Window controls

.au-chrome-button · Border · Desktop chromeButton

Close hover is danger red. Every other chrome hover uses the neutral state layer, never the accent.

Close control

.au-chrome-close · Border · Desktop chromeClose

Only the close control uses danger on hover.

Title tools

.au-title-tool · Border · Desktop titleToolButton

Sidebar and reload sit in the chrome so the workspace rail stays dedicated to workspaces.

Wordmark

.au-chrome-title · TextBlock

Agent-Up

The product name in chrome is 13px bold, not a marketing title.

Workspace name

.au-workspace-name · TextBlock · Desktop wsName

Harbor Shop

The title lives inside the workspace row. Do not restyle it per surface.

Workspace branch

.au-workspace-branch · TextBlock · Desktop wsBranch

main

The subtitle stays muted inside the same row.

Remove workspace

.au-workspace-delete · Button · Desktop wsDeleteButton

Delete stays quiet until hover, then uses danger text.

Lifecycle controls

.au-lifecycle-button · Border · Desktop wsLifecycleButton

Start and stop are compact icon actions, not a second primary CTA.

Browser chrome button

.au-browser-button · Border · Desktop browserButton

Back, forward, and reload use the compact raised icon treatment.

Lockup

.au-logo-lockup · StackPanel

AUAgent-Up

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.

available

Shipped in the current public development-preview build.

preview

Usable, but its contract or experience may change.

experimental

Incomplete, opt-in, or not supported on every platform.

planned

Product direction only; not available to users.