Self-improving AI Employees for everyone
Theme System — design-handoff token contract + 3 themes
The OpenCompany frontend ships three visual themes: the two base themes light and dark, and one stylized skin, atomic (Atomic Modern, in the light family). The design handoff's nine other skins (renaissance, greek, edo, steampunk, cyber, wasteland, rot, plague, surveillance) were removed on 2026-10-12. Home, the editor and the sign-in screen all show the chosen theme, and one theme button steps through the three.
Selected at runtime via <html data-theme="...">. The system is purely CSS-variable-driven: components render against semantic token names, and the active [data-theme="..."] block in client/src/themes/ rebinds those tokens to the theme's surface, foreground, accent, typography, geometry, motion, and sound-pack values.
This document is the playbook for working in the design system: token taxonomy, per-component decoration hooks, per-theme sound + canvas packs, migration recipe, anti-patterns, and where each piece lives.
Canonical reference + token format. The vendored Design System Bundle (
docs-internal/design-system/) is the canonical spec; itstokens/*.csscarry the authoritative values — copy them verbatim, never re-derive by eye. Token colors arehex+color-mix()(e.g.--primary: #2563eb,--action-run-soft: color-mix(in srgb, var(--dracula-green) 15%, transparent)), NOT HSL-triplets. The Tailwind v4@theme inlinebridge maps--color-X: var(--X)directly (nohsl()wrapper); the/opacitymodifier still works because v4 compiles it tocolor-mix. Action intents additionally expose an--action-X-inkreadable-text variant (light: a darkened accent; dark: the raw accent) consumed byActionButtonviatext-action-X-ink.
Architecture at a glance
client/src/themes/ (colour VALUES are hex + color-mix(); never HSL triplets)
├── base.css shared scalars: space / radii / chrome / shadow / type scale, motion
│ easings, the --tint-* alpha scale (single home for color-mix %), node visuals
├── light.css :root + :root[data-theme="light"] — light colour hex: shadcn + dracula
│ + node + action (+ -ink); defined on bare :root so they apply globally
├── dark.css .dark + :root[data-theme="dark"] — dark colour-hex overrides (+ -ink, shadows)
├── atomic.css :root[data-theme="atomic"] — full palette (hex) + per-theme decorations
└── animations.css --pulse-keyframe/-duration/-timing + executing/trigger keyframes
+ .opencompany-* helpers (.opencompany-pulse / -trigger-armed / -bolt / …)
client/src/index.css PLUMBING ONLY — holds NO literal colour values:
├── @layer base global resets only (*, html/body, #root) — token blocks moved to themes/
└── @theme inline { … } Tailwind v4 bridge mapping --color-X: var(--X) (NO hsl() wrapper);
/opacity (bg-primary/50) composes via color-mix for any colour format
client/tailwind.config.js second colour bridge — theme.extend.colors map var(--X) (no hsl() wrapper)
client/src/contexts/ThemeContext.tsx
├── ThemeName = 'light' | 'dark' | 'atomic'; AVAILABLE_THEMES in that order
├── THEME_LABEL — each theme's name wherever one is shown
├── DARK_FAMILY = {dark}
├── persists the chosen theme to localStorage['opencompany-theme']; a saved
│ name that is no longer a theme falls back to the legacy 'darkMode' key,
│ else dark
├── migrates legacy 'darkMode' boolean on first load
├── sets <html data-theme="..."> + .dark class (only for DARK_FAMILY themes)
└── cycleTheme / nextTheme — step to the next theme, wrapping round
client/src/components/ui/ThemeButton.tsx — the one theme control: the Home header,
the editor's toolbar and the sign-in
screen; each press steps Light → Dark
→ Atomic, and its icon and label name
the next theme
client/src/hooks/useAppTheme.ts — Atomic's Colors overlay (canvas + maps)
client/src/lib/sound.ts — WebAudio engine, 3 packs × 9 events
client/src/hooks/useSound.ts — useSoundSync() + useSound()
client/src/components/ui/StatusBar.tsx — fixed-bottom system console
client/src/components/ui/CommandPalette.tsx + CommandPaletteHost.tsx — ⌘K launcher
Token tiers
There are six tiers, ordered from most semantic to most concrete. Always pick the most semantic that fits the call site.
1. New-contract surface tokens (preferred for new code)
Surface hierarchy across themes; every theme assigns these in its :root[data-theme="..."] block.
| Tailwind utility | CSS var | Purpose |
|---|---|---|
bg-bg-app |
--bg-app |
Outer page / root background |
bg-bg-panel |
--bg-panel |
Sidebars, palette, toolbar, footer chrome |
bg-bg-canvas |
--bg-canvas |
The workflow canvas |
bg-bg-elevated |
--bg-elevated |
Modals, dropdowns, popovers, cards inside panels |
bg-bg-input |
--bg-input |
Form-field backgrounds |
bg-bg-hover |
--bg-hover |
Hover state for rows / buttons |
bg-bg-active |
--bg-active |
Selected / pressed state |
bg-bg-overlay |
--bg-overlay |
Modal scrims |
| Tailwind utility | CSS var | Purpose |
|---|---|---|
text-fg-default |
--fg-default |
Primary text |
text-fg-muted |
--fg-muted |
Secondary / metadata |
text-fg-faint |
--fg-faint |
Placeholders / divider text |
text-fg-on-accent |
--fg-on-accent |
Text over --accent fills |
| Tailwind utility | CSS var | Purpose |
|---|---|---|
border-border-default |
--border-default |
Standard borders + dividers |
border-border-strong |
--border-strong |
Section separators, focused panels |
border-border-focus |
--border-focus |
Focus rings (often shadowed) |
(Tailwind v4 names colour utilities border-{token} where {token} is the suffix after --color-; since we expose --color-border-default, the utility is border-border-default.)
| Tailwind utility | CSS var | Purpose |
|---|---|---|
font-display |
--font-display |
Headings, panel titles, action labels (Bevan under Atomic) |
font-body |
--font-body |
Paragraph + UI copy |
font-mono |
--font-mono |
Code, console, JSON, status bar, kbd |
| Tailwind utility | CSS var | Purpose |
|---|---|---|
tracking-[var(--type-tracking-display)] |
--type-tracking-display |
Letter-spacing for display headings |
[text-transform:var(--type-uppercase)] |
--type-uppercase |
Theme-driven uppercase / capitalize / none |
Note: values are hex + color-mix(). Tailwind v4 composes /opacity via color-mix for any colour format, so bg-bg-app/50 does compile and work (to color-mix(in oklab, var(--bg-app) 50%, transparent) behind an @supports guard) — but opacity arithmetic at call sites is forbidden by the frontend rules; use a named token (--bg-overlay, a -soft/-tint variant) instead.
2. shadcn semantic tokens (preserved for primitives)
Standard shadcn keys (background, foreground, card, popover, primary, destructive, success, warning, info, border, input, ring, etc.). Each theme defines them as hex matching the new-contract colour, so shadcn primitives + generic chrome resolve against the active theme. /opacity works on these too (bg-primary/10, text-foreground/80) via v4 color-mix.
3. Action role tokens
Six semantic intents: run | stop | save | config | secret | tools. Each exposes base / -soft / -hover / -border / -ink — the colour-hex bases live in light.css/dark.css and the -soft/-hover/-border tints are color-mix over the base referencing the shared var(--tint-action-*) scale. -ink is the readable label colour (light: darkened accent; dark: raw accent). Read via <ActionButton intent="run"> or directly: bg-action-run-soft text-action-run-ink border-action-run-border. Themes redefine these (or just override the --tint-action-* scalars) in their own block.
4. Node-type role tokens
Six tokens for canvas identity: agent / model / skill / tool / trigger / workflow. Each exposes base / -soft / -border. Used on palette icons, parameter-panel section headers, draggable variable cards. Never use /N opacity arithmetic at call sites — themes own the alpha.
5. Dracula raw accents (palette, not consumed directly)
--dracula-green/purple/pink/cyan/red/orange/yellow/selection/current-line/comment. Same value across light + dark. Used as the underlying palette that --action-X and --node-X reference; do not use directly in components.
6. Code & syntax tokens
--code-* — the per-theme syntax palette for the code editor, console/output JSON viewers, and chat code blocks. Each theme defines its own --code-* block in its own CSS file (client/src/themes/<theme>.css): editor chrome (--code-bg, --code-gutter-bg, --code-gutter-fg, --code-caret, --code-border, --code-line-active, --code-selection) + syntax roles (--code-text, --code-comment, --code-keyword, --code-string, --code-number, --code-boolean, --code-function, --code-property, --code-operator, --code-punctuation, --code-tag). The per-theme --code-* blocks in client/src/themes/*.css are the only home of this tier (the vendored bundle ships no tokens/code.css — the tier postdates it); Atomic derives syntax from its own role hues — keyword→trigger, string→success, number→agent, function→model, tag→tool, comment→faint, punctuation→muted — on an adaptive dark/light code surface (color-mix(#000 45%, --bg-panel) dark, color-mix(#000 5%, --surface-card) light).
Consumed as var(--code-*) in index.css (.code-editor-container, .console-json-output, and in chat replies .chat-markdown pre, whose surface, text and border are --code-bg / --code-text / --code-border on every theme, plus the .chat-markdown .token.* colours shared with the editor) and exposed as Tailwind utilities (text-code-tag, bg-code-bg, …) via the @theme inline bridge; the OutputPanel @uiw/react-json-view viewer reads the same vars. This replaced the old global dracula-hardcoded --prism-* block and the dead getPrismTokenCSS() helper — code/JSON now paints in each theme's palette instead of one dracula scheme everywhere. (prismjs is still the tokenizer; only the colours moved to --code-*.)
Home (Normal mode) tokens
Normal mode (normal_mode.md) adds its own steps, all in
base.css unless noted, and bridged in
index.css where a Tailwind utility needs them (the layout and duration
tokens are used directly, as w-(--w-home-sidebar) or duration-(--dur-slow)):
- Motion:
--ease-spring | overshoot | reveal | shakeand the choreography durations (--dur-intro,--dur-view-swap,--dur-panel-in/-out,--dur-toast-in/-hold/-out,--dur-mode-in/-out,--dur-theme-reveal,--dur-glow,--dur-pip-loop,--dur-dock-infor the Workspace dock,--dur-shake, …). Web Animations read them through lib/motion.ts, whose fallbacks mirror base.css. It also holds the onboarding presets:RISE/rise(el)(up from 16px, scale .98, a 4px blur,card-inon the spring curve) andshake(el)(-6, 5, -3, 2px, each swing on--ease-shake). The CSS loops beside them inanimations.cssare.opencompany-caret-blink(a hard on/off caret) and.opencompany-spinner-slow(the--dur-live-ringpace), drawn as a ring bycomponents/ui/ring-spinner.tsx; both stop under reduced motion. - Radii:
--radius-row | card | panel | draft | composer, multiples of each theme's--radius-lg, so square themes stay square. The Tailwindrounded-sm/md/lg/xlutilities do not follow themes:index.csscomputes them from--radius, which no theme overrides, so they are 4/6/8/12px everywhere.rounded-pill, these Home radii and CSS readingvar(--radius-*)directly do follow the theme. - Type and layout:
--text-meta | row | lead | title | headline | hero(with--tracking-hero,--leading-hero;headlineis 28px, the onboarding headings), and the Home layout constants (--w-home-sidebar,--h-home-header,--w-composer, the orb slot sizes--size-orb-hire | employee | connecting | login, the Settings and Welcome guide dialog sizes--w-settings/--h-settingsand--w-guide/--h-guide). The guide's demo stage is the.home-welcome-stageclass inindex.css(two washes of--node-agent-filland--node-model-softover--bg-app). - Status:
--status-{working,ready,paused,attention,waiting}-{dot,fill,border,ink}for the employee pills and dots. The dot is the raw role colour; light.css keeps the paused dot at the design's mid grey.--shadow-pip(shadow-pip) is a dot's glow in its own colour: give the dot atext-status-*-dotcolour andbg-current. - Errors:
--danger-soft(15%) and--danger-border(45%) tint--destructivefor an error on a Home surface (bg-danger-soft,border-danger-border). - Per family (light.css / dark.css):
--shadow-float | popover | dialog | dock(dockis the Workspace's left shadow when it lies over the page), the node-role-fill / -edge / -hover / -inkvariants, and Home's glows:--glow-connect | hire | hire-settle | refine | refine-out | taskplus the working pip's--tint-pip-ring. Dark keeps the neon; light swaps each neon for its ink at .75 of the alpha and .6 of the blur, the design's rule for white surfaces. The Web Animations that play them name the token (boxShadow: 'var(--glow-hire)'), so the colour follows the theme with no script. dark.css restates each one, because light.css's bare:rootalso matches the dark family.
Home shows the chosen theme, Atomic included, as the editor and the sign-in
screen do (owner decision, 2026-10-12; Home used to show only light and dark).
Atomic inherits light.css's bare :root, so Home's tokens take the light
family's values under it unless atomic.css overrides them.
setTheme(next, { reveal: true, origin })
grows the new theme as a circle from origin (View Transitions), falls back
to a short colour fade, and is instant under reduced motion.
Migration recipe
The single most important rule from the design handoff:
Components render against
var(--token)references only. There is no theme-conditional logic in component bodies. Every visual switch lives in the per-theme CSS file underclient/src/themes/.
Concrete swaps when migrating an existing component:
| Before (legacy) | After (new contract) | When |
|---|---|---|
bg-card (panel chrome) |
bg-bg-panel |
Sidebars, palette, toolbar, footer |
bg-card (elevated card) |
bg-bg-elevated |
Modal heads, dropdowns, settings sections, chat bubbles |
bg-background |
bg-bg-app |
Modal body, page-level backgrounds |
bg-muted (subtle distinct surface) |
bg-bg-app or bg-bg-elevated |
Pick by elevation intent |
border-border |
border-border-default |
Dividers, card outlines |
text-foreground |
text-fg-default |
Body text |
text-muted-foreground |
text-fg-muted |
Secondary text |
text-sm font-medium (display surface) |
font-display tracking-[var(--type-tracking-display)] [text-transform:var(--type-uppercase)] text-fg-default |
Panel titles, section headers, node labels |
text-xs (metadata / counts) |
font-mono text-xs |
Status pills, timestamps, IDs |
<input> field bg |
bg-bg-input |
Form fields |
| Hover row | hover:bg-bg-hover |
Lists, menu items |
| Selected row | bg-bg-active |
Selected workflow cards, active tabs |
| Modal scrim | bg-bg-overlay |
Dialog overlays |
<ActionButton intent="..."> |
unchanged | All toolbar / panel action buttons |
Display-typography helper
Heading surfaces under every theme use the same triplet. Keep them grouped in the same className for clarity:
<span className="font-display tracking-[var(--type-tracking-display)] text-fg-default [text-transform:var(--type-uppercase)]">
{heading}
</span>
Result by theme (display font / tracking / case):
- Light + Dark — Geist Variable / 0 /
none - Atomic — Bevan / 0.06em /
uppercase
Adding a new theme
- Drop a CSS file at
client/src/themes/<name>.css. Required block::root[data-theme="<name>"] { /* New contract — full colour values */ --bg-app: …; --bg-panel: …; --bg-canvas: …; --bg-elevated: …; --bg-input: …; --bg-hover: …; --bg-active: …; --bg-overlay: …; --border-default: …; --border-strong: …; --border-focus: …; --fg-default: …; --fg-muted: …; --fg-faint: …; --fg-on-accent: …; --fg-on-success: …; --fg-on-danger: …; --fg-on-warning: …; --font-display: …; --font-body: …; --font-mono: …; --type-uppercase: none|uppercase|capitalize; --type-tracking-display: 0|0.10em|0.18em; --radius-sm: …; --radius-md: …; --radius-lg: …; --radius-pill: …; /* Shadcn bridge — same colours, HEX (not HSL triplets) */ --background: #rrggbb; --foreground: #rrggbb; --card: #rrggbb; --popover: #rrggbb; --primary: #rrggbb; --secondary: #rrggbb; --muted: #rrggbb; --accent: #rrggbb; --destructive: #rrggbb; --success: #rrggbb; --warning: #rrggbb; --info: #rrggbb; --border: #rrggbb; --input: #rrggbb; --ring: #rrggbb; /* Action role tokens — base hex + color-mix tints over the shared var(--tint-action-*) scale (override --tint-action-* here if the theme wants stronger/weaker tints). -ink = readable label: a darkened accent on light themes, var(--action-X) on dark. */ --action-run: #rrggbb; --action-run-soft: color-mix(in srgb, var(--action-run) var(--tint-action-soft), transparent); --action-run-hover: color-mix(in srgb, var(--action-run) var(--tint-action-hover), transparent); --action-run-border: color-mix(in srgb, var(--action-run) var(--tint-action-border), transparent); --action-run-ink: #rrggbb; /* or var(--action-run) on dark themes */ /* …repeat for stop / save / config / secret / tools */ } - Import it in client/src/main.tsx before
index.css. - Add the name to
ThemeName,AVAILABLE_THEMES(the theme button steps through it in order) andTHEME_LABELin client/src/contexts/ThemeContext.tsx. Add toDARK_FAMILYif the theme's background is dark, and add the name to the pre-paint lists in client/index.html (themePrePaint.test.tschecks them). - Give the theme an icon in
ICONin client/src/components/ui/ThemeButton.tsx; the button shows the next theme's icon. - Nothing else lists themes: Settings → Appearance, the command palette and the status bar read
AVAILABLE_THEMESandTHEME_LABEL. - (Optional, canvas) Add a
THEME_OVERRIDESentry in client/src/hooks/useAppTheme.ts so canvas selection rings, action buttons, and edge strokes pick up the theme's accents. Whichever keys you omit fall through tolightColors/darkColors(chosen byDARK_FAMILY, throughuseTheme().isDarkMode). - (Optional, fonts) If the theme uses Google Fonts not already loaded, append the family to the deferred-load
<link>in client/index.html. - (Optional, sound) Pick one of the existing
SoundPackNamevalues (parchment,terminal,vibraphone) in--sound-pack(or add a new pack to client/src/lib/sound.ts and theVALID_PACKSset in client/src/hooks/useSound.ts). - (Optional, motion) The theme inherits the default
node-pulseexecuting glow and the.opencompany-trigger-armedtrigger heartbeat automatically. For a bespoke executing pulse, add a[data-theme="X"]block in client/src/themes/animations.css overriding--pulse-keyframe/--pulse-duration/--pulse-timingand define that keyframe there. Set the glow accent via--node-pulse-colorin the theme's own block.
No component code changes. That is the contract.
Anti-patterns (forbidden)
- Theme-conditional logic in components. No
if (theme === 'atomic')branches. Visual differences live in the per-theme CSS file. - Whole-store Zustand destructure. Always
useAppStore((s) => s.x), never{ x } = useAppStore(). - Ad-hoc opacity arithmetic on role/surface tokens. Don't inline alpha (
bg-bg-app/10,bg-node-agent/30,bg-action-run/25). Tailwind v4 can now color-mix/opacityon hex tokens, but the discipline is to reference a NAMED token: add/define a-soft/-hover/-bordervariant, or a--tint-*step in base.css, and use it by name. - Hardcoded colours. No
bg-white,bg-black,text-gray-500,style={{ backgroundColor: '#fff' }}. Use tokens. useAppTheme()in new files. Allowed only for surfaces that need JS-side hex values Tailwind can't express: canvas node components (AIAgentNode,SquareNode,TriggerNode,StartNode),EdgeConditionEditor, and the Google Maps SDK consumers (GoogleMapsPicker,MapsPreviewPanel) — note the map tiles themselves are deliberately left to Google's own styling;useAppThemehere covers only the surrounding chrome. Every other surface uses Tailwind + tokens. New themes contribute touseAppThemevia aTHEME_OVERRIDESentry, never by importinglightColors/darkColorsdirectly.- Hand-rolled modal backdrops. Use
<Modal>fromclient/src/components/ui/Modal.tsx. - Hand-rolled colored buttons. Use
<ActionButton intent="...">. - Static fallback theme palettes in TS. Themes live in CSS (
client/src/themes/<name>.css), not TS exports.client/src/styles/theme.tsships only the twolightColors/darkColorsbase packs thatuseAppThemeoverlays on top of — it is not a place to add a third / fourth / Nth palette.
What's done vs deferred
Done
--node-pulse-colorcontract — executing-node glow color is independent of--node-color(the plugin accent). Atomic sets--node-pulse-colorto its--accent(light/dark deliberately keep the base.cssvar(--info)fallback) so the glow stays visible against any canvas background. Defined in base.css at:root, overridden in the theme's own file. The executing keyframe (node-pulse) and the--pulse-keyframe/--pulse-duration/--pulse-timingtokens live in animations.css; base.css's.sq-node[data-executing] .sq-node-box/.react-flow__node.executing .{sq-node-box,node}rule readsvar(--pulse-keyframe, node-pulse), so a theme can pick its own pulse by overriding ONE token (the removed Cyber, Surveillance and Renaissance skins did; no remaining theme does).node-pulseis a triple-layer expanding box-shadow (12px ring + 32px mid halo + 56px outer halo) consumingvar(--node-pulse-color)+ the shared--tint-pulse-*alphas. Trigger nodes use a separate continuous.opencompany-trigger-armed"listening" heartbeat (trigger-listeningkeyframe) while waiting, plus.opencompany-bolton the ⚡ badge — distinct from the one-shot execution pulse. Never animateopacityon whole-node selectors — it fades the node icon + content, not just the glow.data-page-hiddenanimation pause —usePageActivitySync()(app/usePageActivitySync.ts), mounted once in App.tsx, above the sign-in gate, so it covers every screen (sign-in and Connecting included), listens tovisibilitychangealone and togglesdata-page-hiddenon<html>(Chrome reports a minimised or fully covered window as hidden too; a visible window that is only unfocused, such as the app beside an editor, keeps animating); base.css declareshtml[data-page-hidden] *, *::before, *::after { animation-play-state: paused !important; }. Without this, paused CSS keyframes accumulate frames in the compositor queue while the tab is hidden; on tab return all 50+ executing nodes' triple-layer pulses resume simultaneously, stalling the GPU compositor 100-200ms and blocking input dispatch (first-click-feels-frozen pattern). The unpause is deferred tworequestAnimationFrameticks so input dispatch wins the frame before composite resumes.- Parameter panel theme contract — MasterSkillEditor, OutputPanel, MiddleSection, ParameterPanel removed
useAppTheme(). Every surface renders against Tailwind tokens + new-contract CSS custom props. Section headers carry the display-typography triplet (font-display tracking-[var(--type-tracking-display)] [text-transform:var(--type-uppercase)] text-fg-default); action buttons use<ActionButton intent="run|stop|save|config|tools">; backgrounds usebg-bg-elevated/bg-bg-panel/bg-bg-inputfrom the surface tier table above. EditableNodeLabel emits bothsq-node-labelandnode-labelclassNames so per-theme typography rules fire under either topology. Scrollbar webkit rules (::-webkit-scrollbar-thumbetc.): the global token rules in index.css for every theme, plus Atomic's square-cornered ones. - Canvas-node class topology alignment (W26) — TriggerNode, StartNode, ToolkitNode migrated from
.node(rectangular spec-card) topology to.sq-node/.sq-node-box(square-icon node) topology so per-theme decorations (Atomic's square-node styling) reach them. Status pips, gear buttons, and React Flow handles on every node component now carry.sq-node-pip/.sq-node-gear/.sq-node-handle.in/.out(square nodes) or.node-pip/.node-gear/.node-handle.in/.out(rectangular nodes — AIAgentNode, TeamMonitorNode; the formerGenericNodewas retired with the spec-driven canvas). Pip background is data-driven viadata-status="idle | executing | waiting | success | error"— base.css picks the colour from shadcn semantic tokens; per-theme files override. Inline JS-computedbackgroundColor/border/animationon these elements stripped — CSS owns visuals. Orphan.node-outputrule removed. EditableNodeLabel now emits bothsq-node-labelandnode-labelclassNames so per-theme typography rules fire. StartNode readsnodeColorfromdefinition?.defaults?.colorinstead of hardcodedtheme.dracula.cyan; the NodeSpec adapter never fills that field, so it resolves tovar(--node-workflow). - Audio fix (W20) —
--sound-pack: chimetypo inlight.css+dark.csswas silently falling through to'none'(chimenot in the engine's pack registry), making sound silent for the most-used themes. Renamedlight→parchment,dark→terminal. AddedSounds.unlock()exported from lib/sound.ts plus a one-shotpointerdown / keydown / touchstartcapture-phase listener inuseSoundSync()(hooks/useSound.ts) so the AudioContext resumes on the user's first gesture (Chrome / Safari autoplay policy compliance). - Canvas-node visual contract (W21) — every node component (
AIAgentNode,SquareNode,TriggerNode,StartNode,ToolkitNode,TeamMonitorNode;GenericNodeat the time, since retired) stripped its inlinebackground/border/borderRadius/boxShadow/animationprops. Each now exposes its accent viastyle={{ '--node-color': accentColor }}on its outer wrapper. Visual styling lives in base.css defaults + per-theme overrides;var(--node-color)carries that accent through CSS without fighting specificity. OnlyAIAgentNodepasses the plugin's own colour (NodeSpeccolor); the other node components pass their role token (see "Canvas-node visual contract" below). NewNodeStylehelper type in client/src/types/NodeTypes.ts (React.CSSProperties & Record<\--${string}`, string | number>`) makes the inline custom-prop typecheck-clean. - Icon size is a token —
NodeIcontakessize=(theme.nodeSize.squareIcon, 36px, on every canvas node; atheme.iconSize.*step elsewhere) and applies it as width, height and emoji font size together. Sizing classes are never passed:--text-3xlis 44px inbase.css, so atext-3xlemoji once dwarfed every SVG-backed node next to it. - Per-theme icons (W23) — client/src/assets/icons/themedGlyphs.ts holds Atomic's 29 SVG glyphs, ported from
design_handoff_machinaos_themes/app/icons.js(the other nine skins' sets went with them). NodeIcon.tsx consultsTHEMED_GLYPHS[activeTheme][key]first; falls through tolucide-react/lobehub:/asset:dispatch on miss. Light and dark have no entries — they fall through to existing dispatch. - Editor dot grid — the Dev canvas renders React Flow's dots
<Background>(Dashboard.tsx), filled with--grid-dot(index.css). base.css declares ittransparent; only the base themes set it, in blocks that match[data-theme="light"]/[data-theme="dark"]alone (--fg-mutedat 20% / 22%), so Atomic's--canvas-griddecoration never gets dots over it. The same light-only block setscolor-scheme: light(dark.css already setsdark). Locked bythemes/__tests__/themeTokens.test.ts. - Scrollbars — the global rules in index.css read
--scrollbar-track/--scrollbar-thumb(hover--fg-faint), which every theme declares; Atomic's own scoped rules still apply on top. - Canvas grid + cursors (W24) —
--canvas-gridand--cursor-defaultslots declared in base.css and bound to.canvas-host. Atomic draws its mid-century starburst through--canvas-grid; no remaining theme sets a custom cursor (the removed Cyber, Surveillance and Renaissance skins did). - Decorative HTML primitives (W25) — removed.
SvgFilterDefs(the#ink-blot/#noise/#crtSVG filters) went on 2026-10-12 with the skins it was meant for; no CSS read its filters. TheDropCapwrapper planned alongside it was never retained. The bare.v-displaydisplay-typography co-class remains; Atomic styles it. - Token contract: the three themes in client/src/themes/ (light, dark and atomic, the one skin kept of the ten ported from the handoff), in five CSS files (base + animations + the three themes).
- ThemeProvider (client/src/contexts/ThemeContext.tsx) — three-way
ThemeName,DARK_FAMILY={dark},cycleTheme, legacydarkModelocalStorage migration on first load - ThemeButton — one button in both modes and on the sign-in screen, stepping Light → Dark → Atomic. On 2026-10-12 it replaced the editor's grouped theme menu and Home's light/dark toggle.
- Tailwind v4
@theme inlineexposing new-contract utilities (bg-bg-app,text-fg-default,border-border-default,font-display,font-body,rounded-pill) - Decorative wrappers — the React Flow host carries
canvas-host(aliased ascanvasso handoff selectors resolve), which Atomic's starburst targets. Theapp-frame(app shell) andmodal-frame(Modal) hooks went with the removed skins, the only CSS that styled them. - Per-component structural classNames (W15) — every chrome / interactive / canvas component carries the handoff selector co-class so per-theme decorative rules resolve without component-level branching. See Per-component decorations for the full list.
- Per-theme decorative CSS (W16) — every per-component rule from
design_handoff_machinaos_themes/themes/*.cssis now ported intoclient/src/themes/<theme>.css. Each skin owned its panel textures, canvas decorations, node pseudo-element overlays, and keyframes. CSS bundle: 145 KB → 244 KB (+99 KB); removing nine of the ten skins on 2026-10-12 took the main CSS bundle from 339 kB to 217 kB. - Selection state (W17, shipped as part of W15) — every canvas node component carries the
selectedco-class when React Flow'sselectedprop is true, activating per-theme selection effects (Atomic's selected square node). - Sound event wiring (W18) — 9 events (
click,hover,type,success,error,run,save,modalOpen,modalClose) fire automatically across the React tree. See Sound system → Event wiring. - Success is a moment, not a state — terminal node statuses persist in
nodeStatusStoreuntil the next run, so the static--successring/stroke on.react-flow__node.completed(base.css) and.react-flow__edge.completed(styles/canvasAnimations.ts) previously left every completed agent/tool node and traversed edge glowing green indefinitely. Both are now one-shot fades (node-completed-fadein animations.css /edgeCompletedFade): hold the success token briefly, then settle back to the resting border/stroke.prefers-reduced-motionkeeps the static ring (legible outcome, no motion). Error states deliberately stay painted until acted on. - Reduced-motion accessibility (W19) —
@media (prefers-reduced-motion: reduce)block in client/src/themes/base.css disables every keyframe across all themes. See Reduced motion. - Sound throttling (W19) —
typeandhoverevents throttled to a 30 ms last-fire window inside the engine to prevent OscillatorNode flooding. See Throttling. - Migrated chrome: TopToolbar, WorkflowSidebar, ComponentPalette + ComponentItem + CollapsibleSection, ConsolePanel chrome, SettingsPanel, Modal, ParameterPanel modal title, AIResultModal title, InputSection title
- New shell components: StatusBar (fixed-bottom system line with WS connection / workflow / theme / clock), CommandPalette (
⌘K), CommandPaletteHost (canonical command list with Workflow / Run / Open / View / Theme groups) - Google Fonts — the deferred-load
<link>covers Atomic's typefaces only (Bevan, Lato, Space Mono); light and dark use the bundled Geist and the system mono. It loaded seventeen families for the twelve themes until 2026-10-12. - Sound contract — client/src/lib/sound.ts ports the upstream WebAudio engine with the packs the themes use (
parchmentfor light,terminalfor dark,vibraphonefor atomic; the other seven went with the removed skins). client/src/hooks/useSound.ts reads--sound-packfrom:rooton theme change and mirrors thesoundEnabledZustand slice intoSounds.setEnabled(). Settings panel ships the toggle (Audio section). Persists tolocalStorage['opencompany-sound']; default ON (browsers gesture-gate WebAudio without a separate permission API — the AudioContext starts suspended and resumes on the user's first pointerdown / keydown / touchstart viaSounds.unlock(), registered as a one-shot capture-phase listener inuseSoundSync()). - Canvas overlay packs — client/src/hooks/useAppTheme.ts applies a small
THEME_OVERRIDESoverlay (primary, focus, focusRing, action colours) on top oflightColors/darkColors; Atomic is the only theme with one. Existing call sites continue to readtheme.colors.Xandtheme.isDarkModeunchanged.
Deferred (future PRs)
--*-softtoken family — RESOLVED (theme fidelity pass):--info-soft/--success-soft/--warning-soft/--danger-soft(plus the--dangeralias for--destructive) are now declared inbase.css:rootascolor-mix(in srgb, var(--X) var(--tint-semantic-soft), transparent)with--tint-semantic-soft: 15%on the shared tint scale. Theme rules that read them (Atomic's selected workflow card reads--warning-soft) render their intended tinted fills instead of computing to invalid-and-transparent. Themes may override any of them.- Atomic canvas-host pseudo-element decoration — Atomic's richer canvas overlay (the dot constellation) is a pseudo-element decoration rather than a tileable
--canvas-gridpattern; W24 ported the tileable layer only. Wire via.canvas::before/::afterrules in a future pass if needed. - Parameter panel internals — RESOLVED:
ParameterRenderer,MiddleSection,MasterSkillEditorare fully on shadcn primitives + tokens (zerouseAppTheme/theme.colors); section headers carry the display-typography triplet. The panel modal also picks up per-theme.modal/.modal-head/.modal-titledecoration viaModal.tsx. - Credentials modal sub-panels —
OAuthPanel,EmailPanel,ApiKeyPanel,QrPairingPanelheaders same pattern.
Per-component decorations
Wave 15 added structural classNames across the React tree so the handoff CSS selectors resolve without component-level branching. Wave 16 ported the matching decorative rules from design_handoff_machinaos_themes/themes/*.css into client/src/themes/<theme>.css; since 2026-10-12 only Atomic's remain.
Class registry
| Surface | className(s) | Component |
|---|---|---|
| Top toolbar | .toolbar |
TopToolbar |
| Sidebar | .sidebar |
WorkflowSidebar |
| Component palette | .palette |
ComponentPalette |
| Console / chat panel | .chat |
ConsolePanel (root) |
| Chat turns (Home and Dev) | .chat-msg .chat-msg-user on the owner's bubble; .chat-msg .chat-msg-bot on a reply's text only; .chat-turn-user, .chat-turn-bot on each turn; .chat-composer on the message box; .chat-approval on a draft's card; .chat-genui on a generated interface |
features/chat (UserTurn, AssistantTurn, Composer, approval/ApprovalCard, turns/GeneratedUiBlock) |
| Status bar | .statusbar, .pip (connection dot) |
StatusBar |
| Modal | .modal, .modal-head |
Modal |
| Collapsible section | .cat, .cat-head, .cat-body |
CollapsibleSection |
| Workflow card | .wf-card |
WorkflowCard |
| Palette tile | .comp |
ComponentItem |
| Interactive list rows | .row |
WorkflowSidebar / ComponentItem |
| shadcn Button | .btn (CVA base) |
button.tsx |
| ActionButton | .action-btn .btn (CVA base) |
action-button.tsx |
| Form field | .input |
input.tsx, textarea.tsx |
| Dropdown menu | .menu-pop (Content), .menu-pop-item (Item) |
dropdown-menu.tsx |
| Canvas host | .canvas-host, .canvas (alias) |
Dashboard |
| Generic canvas node | .node, .selected |
AIAgentNode, GenericNode, TriggerNode, StartNode |
| Agent node variant | .node-agent |
AIAgentNode |
| Trigger node variant | .node-trigger |
TriggerNode |
| Square canvas node | .sq-node, .sq-node-box, .sq-node-pip, .sq-node-gear, .sq-node-handle.in, .sq-node-handle.out, .selected |
SquareNode |
The .selected co-class is bound to React Flow's selected prop on every canvas node component, activating per-theme selection effects (Atomic's selected square node).
A reply has no bubble in light and dark (design handoff chat): only the owner's message is one. Atomic still paints .chat-msg-bot as a bubble, so its rule carries the padding the bare reply lacks (padding: 8px 12px).
Decorative content per theme
| Theme | Panel textures | Canvas decoration | Node pseudo overlay | Keyframes |
|---|---|---|---|---|
| atomic | flat solid | starburst + grid lines | boomerang corners | — |
Token reads use var(--token) directly (no hsl() wrapper) — every colour value is hex / color-mix(), including the shadcn-bridged tokens and Atomic's spot colours (--mustard, --slate, --turquoise).
Canvas-node visual contract (W21)
Every canvas-node React component renders against pure CSS for visual styling. The component is responsible for:
Setting
--node-colorinline on its outer wrapper:<div className={`node node-agent ${selected ? 'selected' : ''}`} style={{ '--node-color': accentColor, /* layout only */ } as NodeStyle} >In
AIAgentNode,accentColoris the plugin's colour fromuseNodeSpec(type)(NodeSpeccolor, from the plugin'smeta.jsonorvisuals.json).SquareNode,TriggerNodeandStartNodeusedefinition?.defaults?.color, whichnodeSpecToDescriptionnever fills, so they always fall back to their role token:var(--node-model),var(--node-trigger)andvar(--node-workflow)respectively. Plugin colours therefore do not reach those nodes today.Keeping ONLY layout inline —
position,padding,display,flex*,gap,width,height,transition,cursor,fontFamily,fontSize. React Flow<Handle>positioning (position: absolute; left/top/right/bottom) MUST stay inline.Letting CSS own everything visual —
background,border,borderRadius,boxShadow,animationlive in base.css defaults + per-theme overrides. Both consumevar(--node-color)for accent surfaces.
NodeStyle (types/NodeTypes.ts) is the helper type for inline custom-prop typecheck-cleanliness:
export type NodeStyle = React.CSSProperties & Record<`--${string}`, string | number>;
The selected co-class (driven by React Flow's selected prop) and the data-executing attribute (driven by SquareNode's isGlowing minimum-glow timer) toggle execution / selection visuals via CSS. The wider .react-flow__node.executing .node selector is bound by client/src/styles/canvasAnimations.ts for the standard pulse animation.
Anti-pattern: never set background / border / borderRadius / boxShadow inline on canvas-node components. Inline styles win specificity and block per-theme decorations from rendering.
Class topology (W26)
Two visually distinct node families, each with its own class hooks. Pick the right one when adding a new canvas-node component:
| Family | Outer class | Inner box | Pip | Gear | Handle | Label | Used by |
|---|---|---|---|---|---|---|---|
| Square-icon | .sq-node |
.sq-node-box |
.sq-node-pip |
.sq-node-gear |
.sq-node-handle.in / .sq-node-handle.out |
.sq-node-label |
SquareNode, TriggerNode, StartNode |
| Rectangular | .node (+ optional .node-agent / .node-trigger co-class for type-specific theming) |
(none — single-div card) | .node-pip |
.node-gear |
.node-handle.in / .node-handle.out |
.node-label |
AIAgentNode (GenericNode was retired) |
Both families share the same status-pip data contract:
<div className="sq-node-pip" data-status={pipStatus} /> // or className="node-pip"
pipStatus is a string from the bucket 'idle' | 'executing' | 'waiting' | 'success' | 'error'. base.css colors the pip per-status using var(--success) / var(--destructive) / var(--node-color) etc. Per-theme files override for material-specific identity.
Execution-state animation: data-executing={isExecuting ? '' : undefined} on the outer wrapper. base.css binds .sq-node[data-executing] .sq-node-box and .react-flow__node.executing .node to var(--pulse-keyframe, node-pulse) (the theme-selected pulse; keyframes + per-theme --pulse-keyframe live in animations.css). Trigger nodes apply .opencompany-trigger-armed (continuous listening heartbeat) on the waiting state instead — distinct from the execution pulse — plus .opencompany-bolt on the ⚡ badge.
Selection state: selected co-class on the outer wrapper, driven by React Flow's selected prop.
Type-specific co-classes (.node-agent, .node-trigger) are hooks no theme styles today (Cyber, which coloured them, was removed); a theme that wants per-type colours can target them.
Canvas-wide edge + node status animations (canvasAnimations.ts)
client/src/styles/canvasAnimations.ts owns the @keyframes + .react-flow__edge.{status} rules injected once into Dashboard's <style> tag. It is the single home for canvas-wide rules that need to match React Flow's wrapper classes (per-node inline animations live in their own components and read theme tokens directly — see the visual contract above).
Fully static since the design-handoff edge migration. buildCanvasStyles() takes no arguments and the stylesheet is built once at module scope in Dashboard — every colour, width, and dash rhythm is a CSS token, so theme switches restyle it via variable resolution, never a rebuild. The old CanvasStatusColors interface (per-theme hex packs fed from useAppTheme) was deleted; do not reintroduce it — add a token instead.
Edge visual contract (design-handoff):
- Resting edges are one pale neutral:
stroke: var(--edge-stroke)(a--fg-defaultmix at--tint-edge, default 62%),stroke-width: var(--edge-stroke-width)(1.5px),stroke-dasharray: var(--edge-dash)(5 5), orthogonalstepgeometry (defaultEdgeOptions.type: 'step';ConditionalEdgeusesgetSmoothStepPath({borderRadius: 0})). The built-insmoothstepname is remapped to React Flow'sStepEdgerenderer in Dashboard'sedgeTypes, so persisted pre-step workflows render orthogonal without data migration. The in-progress connection line (.react-flow__connection-path) shares the resting rule; Dashboard passes noconnectionLineStyle. - Status classes recolor with semantic tokens so runtime feedback survives in every theme:
selected→--accent,executing→--node-pulse-color+dashFlowmarching ants,completed→--success,error→--destructive,pending→--fg-muted+dashFlow,memory-active→--node-agent,tool-active→--node-tool,skill-active→--node-skill. Widths come from--edge-stroke-width-active(2.5px) /--edge-stroke-width-done(2px); the active dash rhythm is--edge-dash-active(8 4). All edge tokens live in base.css; themes may override any of them. - No
!importanton the resting rule (nothing competes — Dashboard inlines no stroke); status rules keep!importantso they beat the resting rule and ConditionalEdge's inline conditional-accent styling during runs.dashFlowstops underprefers-reduced-motion.
No nodeGlow keyframe here. This module used to inject a nodeGlow keyframe targeting the React Flow wrapper, but it was dead code (only the inner .node child animated) and was removed. Node execution glow is owned solely by base.css — the node-pulse keyframe + .react-flow__node.executing .node / .sq-node[data-executing] .sq-node-box rules (see --node-pulse-color contract above). Do not re-introduce a competing nodeGlow keyframe here. Success/error outcome glow also lives in base.css: the Wave-29 data-status selectors plus .react-flow__node.completed/.error class twins that fire from Dashboard's execution-status classNames (the classNames are the trigger; data-status on the box remains the per-theme override contract).
Sound system
Each theme declares --sound-pack: "<pack>" in its :root[data-theme="..."] block. Pack names map to event tables in client/src/lib/sound.ts:
| Theme | Pack | Voice |
|---|---|---|
| light | parchment (light.css) |
Soft sine plucks + low-pass |
| dark | terminal (dark.css) |
Square-wave terminal beeps |
| atomic | vibraphone |
Mid-century jazz mallet |
Event wiring (W18)
9 events fire automatically across the React tree — call sites do not need to wrap:
| Event | Surface | File |
|---|---|---|
click |
shadcn Button onClick | button.tsx |
click |
ActionButton (CVA primitive) | action-button.tsx |
click |
DropdownMenuItem onSelect | dropdown-menu.tsx |
click |
SelectItem onClick | select.tsx |
hover |
Global capture-phase mouseover delegate matching .btn, .action-btn, .row, .menu-pop-item, .wf-card, .comp, .cmdk-item, [data-sound-hover] |
hooks/useSound.ts |
type |
Input onChange | input.tsx |
type |
Textarea onChange | textarea.tsx |
success |
Monkey-patched toast.success (sonner) — idempotent under React Strict Mode |
hooks/useSound.ts (patchToast()) |
error |
Monkey-patched toast.error (sonner) |
hooks/useSound.ts |
run |
withSound('run', handleDeploy) / withSound('run', handleRun) at TopToolbar onDeploy / onRun + CommandPaletteHost handlers |
Dashboard.tsx |
save |
withSound('save', handleSave) at TopToolbar onSave + CommandPaletteHost + Ctrl/Cmd+S keyboard shortcut |
Dashboard.tsx |
modalOpen / modalClose |
useEffect on isOpen edges in Modal |
Modal.tsx |
The hover delegate uses mouseover on capture phase + a relatedTarget filter so a hover only fires once per crossing-into-element (mouseenter doesn't bubble). touchstart is registered alongside on the same selector list for hybrid devices.
patchToast() wraps sonner's toast.success / toast.error once at module load; the guard flag prevents Strict-Mode double-wrap. withSound(event, handler) is the convenience HOC exported from useSound.ts for run / save semantics — fires the sound, then defers to the original handler.
Wiring summary:
- Mount
useSoundSync()once at the app shell — done in AppShell.tsx'sShellEffects, so it runs on both Home and the editor. - Settings panel ships an Audio section with a Switch bound to
useAppStore.soundEnabled.
Adding a new sound event: extend SoundEvent in lib/sound.ts, add an entry per pack, fire play('<event>') from the handler.
Reduced motion
client/src/themes/base.css ships a @media (prefers-reduced-motion: reduce) block that disables every keyframe across all themes when the user's OS-level "Reduce Motion" preference is on. Disabled animations:
- generic
.animate-pulse(used by node execution pip) - the executing node pulse on BOTH node families —
.react-flow__node.executing .node(rect) and.react-flow__node.executing .sq-node-box/.sq-node[data-executing] .sq-node-box(square; Square/Trigger/Toolkit/Start nodes are the dominant canvas topology, so the square selectors are load-bearing) - the edge
dashFlowmarching-ants animation on.executing/.pendingedges (guarded inside canvasAnimations.ts's injected stylesheet)
Sounds are not motion — they remain enabled regardless. The user-facing audio toggle lives in Settings → Audio → Sound effects.
Verify in Chrome DevTools → Rendering → "Emulate CSS media feature prefers-reduced-motion: reduce", or in OS settings (macOS: System Settings → Accessibility → Display → Reduce motion; Windows: Settings → Accessibility → Visual effects → Animation effects).
Throttling
Two events flood under rapid input and are throttled inside the engine to prevent OscillatorNode flooding:
type— 30 ms last-fire window (protects against keystroke bursts)hover— 30 ms last-fire window (protects againstmouseoverfiring dozens of times during a fast cursor sweep)
Implementation lives in client/src/lib/sound.ts: Sounds.play() consults a THROTTLE_MS map per event name and a lastFireMs map keyed by event before each OscillatorNode schedule. Other events (click, success, error, run, save, modalOpen, modalClose) fire on every call.
Canvas overlay packs (useAppTheme)
The hook returns a theme object with the same shape every call site already destructures — theme.colors.X and theme.isDarkMode continue to work. Under Atomic a small overlay merges into the base pack:
const THEME_OVERRIDES: Partial<Record<ThemeName, ColorOverride>> = {
atomic: {
primary: '#e85a26', // atomic orange
focus: '#e85a26',
actionSave: '#3a9aa0', // turquoise
/* ... */
},
};
The overlay only re-binds the keys most visible on the canvas (primary, focus, action buttons). Canvas edge strokes are no longer part of the packs — the design-handoff edge migration moved them to CSS tokens (--edge-* in base.css + semantic status recolors in canvasAnimations.ts); do not reintroduce edge* keys here. Everything else (background, text, border) stays on the chosen base pack (darkColors when useTheme().isDarkMode, lightColors otherwise). Adding a new theme means adding one THEME_OVERRIDES entry; missing entries are a no-op (theme falls back to pure light/dark).
Verification checklist
When changing a component, verify under all three themes, on Home and in the editor (both show the chosen theme):
cd client && bun run dev
<html data-theme="light">— clean default, near-white surfaces<html data-theme="dark">— neutral slate + Dracula<html data-theme="atomic">— mid-century: Bevan headings, Lato body, Space Mono code, orange and turquoise accents
Build + typecheck must stay clean:
cd client && bun run typecheck && bun run build
Touched components should pass lint:
cd client && bun x eslint <files>
File index
| File | Role |
|---|---|
| client/src/themes/base.css | Shared scalars (space / radii / chrome / shadow / type) + --tint-* alpha scale + node-visual contract |
| client/src/themes/light.css | Light colour hex (shadcn + dracula + node + action + -ink); on bare :root so global |
| client/src/themes/dark.css | Dark colour-hex overrides (+ -ink, deeper shadows) |
| client/src/themes/atomic.css | Atomic Modern theme + bridge |
| client/src/themes/animations.css | --pulse-keyframe tokens + executing / trigger keyframes + .opencompany-* helpers |
| client/tailwind.config.js | Colour bridge (theme.extend.colors → var(--X), no hsl()) |
| client/src/index.css | Plumbing: global resets + @theme inline var() bridge (no literal colours) |
| client/src/contexts/ThemeContext.tsx | <ThemeProvider> + useTheme() (three themes, cycleTheme, THEME_LABEL) |
| client/src/hooks/useAppTheme.ts | Canvas overlay pack (Atomic's Colors override) |
| client/src/lib/sound.ts | WebAudio engine — 3 sound packs, 9 events |
| client/src/hooks/useSound.ts | useSoundSync() + useSound() React glue |
| client/src/components/ui/ThemeButton.tsx | The theme button (both modes + sign-in): steps Light → Dark → Atomic |
| client/src/components/ui/StatusBar.tsx | Fixed-bottom system line |
| client/src/components/ui/CommandPalette.tsx | ⌘K palette primitive |
| client/src/components/ui/CommandPaletteHost.tsx | Registered command set |
| client/src/components/ui/action-button.tsx | CVA action role primitive (fires play('click')) |
| client/src/components/ui/Modal.tsx | Shared modal layout (fires play('modalOpen'/'modalClose')) |
| client/src/assets/icons/themedGlyphs.ts | Per-theme SVG glyph map (Atomic's 29 glyphs) — Wave 23 |
| client/src/assets/icons/NodeIcon.tsx | Theme-aware icon resolver (consults THEMED_GLYPHS first) |
| client/src/types/NodeTypes.ts | NodeStyle helper type for inline --* custom props — Wave 21 |
| client/index.html | Pre-paint theme script + Google Fonts loading (Atomic's typefaces) |
design_handoff_machinaos_themes/ (external design handoff, not in repo) |
Reference HTML mocks + token spec |
design_handoff_machinaos_themes/app/icons.js (external) |
Upstream icon source (ported by Wave 23) |
design_handoff_machinaos_themes/MIGRATION_PLAYBOOK.md (external) |
Upstream recipe — all originally-deferred items now landed (W14–W25) |
design_handoff_theme_system/ (external, 2026-08 — fully migrated, removed from disk) |
Second handoff drop: its themes/ CSS was byte-identical to live, tokens//components//guidelines/ matched the vendored bundle; the new content (handoff brief + 17-panel × 12-theme mockup) was merged as design-system/HANDOFF.md + design-system/reference-mockup/, and the fidelity-pass contracts it specified (step edges, outcome glow, toolbar pinning, font substitutions, reduced-motion coverage) are implemented |