Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.
version: 3.1 name: Dodaios description: >- The design system for the Dodaios desktop application. Graphite surfaces provide visible edges and readable text. Bundled typefaces keep the interface consistent offline. One signal blue, four semantic tones, coloured diffs and a coloured run graph communicate actions and state. Light mode preserves those roles with an inverted surface scale.
colors:
--- Dark: the product default. Graphite, edged, brightly inked. -----------
dark-room: "#121212" dark-rail: "#171717" dark-object: "#1F1F1F" dark-lift: "#292929" dark-speaker: "#2E2E2E" dark-float: "#303030" dark-rim: "#2B2B2B" dark-rim-strong: "#404040" dark-ink-strong: "#FAFAFA" dark-ink: "#F0F0F0" dark-ink-meta: "#A3A3A3" dark-ink-faint: "#7A7A7A" dark-fill: "#FFFFFF" dark-on-fill: "#121212"
--- Light: the same roles, scale inverted. Warm paper, warm ink. ---------
light-room: "#F7F7F4" light-rail: "#F1F0EA" light-object: "#FFFFFF" light-lift: "#E6E5E0" light-speaker: "#E6E5E0" light-float: "#FFFFFF" light-rim: "#DFDDD5" light-rim-strong: "#BDBAB0" light-ink-strong: "#171610" light-ink: "#26251E" light-ink-meta: "#66635A" light-ink-faint: "#8B877C" light-fill: "#26251E" light-on-fill: "#F7F7F4"
--- Signal and semantic roles, with values for each appearance. ---------
dark-signal: "#81A1C1" dark-life: "#3FA266" dark-fault: "#E34671" dark-degraded: "#F1B467" dark-info: "#88C0D0" dark-diff-add-ink: "#70B489" dark-diff-add-ground: "#3FA266 @ 18%" dark-diff-del-ink: "#FC6B83" dark-diff-del-ground: "#B80049 @ 20%" light-signal: "#2778C1" light-life: "#007041" light-fault: "#BE1744" light-degraded: "#A46700" light-info: "#176C74" light-diff-add-ink: "#007041" light-diff-add-ground: "#00B068 @ 18%" light-diff-del-ink: "#BE1744" light-diff-del-ground: "#FF617B @ 22%"
typography: display: fontFamily: "'Space Grotesk', 'Inter Variable', system-ui, sans-serif" fontSize: 24px fontWeight: 600 lineHeight: 1.2 letterSpacing: -0.02em page: fontFamily: "'Inter Variable', 'Inter', system-ui, sans-serif" fontSize: 20px fontWeight: 600 lineHeight: 1.3 letterSpacing: -0.015em title: fontFamily: "'Inter Variable', 'Inter', system-ui, sans-serif" fontSize: 15px fontWeight: 600 lineHeight: 1.4 letterSpacing: -0.01em reading: fontFamily: "'Inter Variable', 'Inter', system-ui, sans-serif" fontSize: 15px fontWeight: 400 lineHeight: 1.6 letterSpacing: 0 body: fontFamily: "'Inter Variable', 'Inter', system-ui, sans-serif" fontSize: 14px fontWeight: 400 lineHeight: 1.5 letterSpacing: -0.01em label: fontFamily: "'Inter Variable', 'Inter', system-ui, sans-serif" fontSize: 14px fontWeight: 500 lineHeight: 1.5 letterSpacing: -0.01em meta: fontFamily: "'Inter Variable', 'Inter', system-ui, sans-serif" fontSize: 13px fontWeight: 400 lineHeight: 1.45 letterSpacing: -0.01em micro: fontFamily: "'Inter Variable', 'Inter', system-ui, sans-serif" fontSize: 11px fontWeight: 500 lineHeight: 1.4 letterSpacing: 0.01em numeral: fontFamily: "'Space Grotesk', 'Inter Variable', sans-serif" fontSize: 24px fontWeight: 600 lineHeight: 1.1 letterSpacing: -0.03em fontVariantNumeric: tabular-nums code: fontFamily: "'JetBrains Mono', ui-monospace, Consolas, monospace" fontSize: 13px fontWeight: 400 lineHeight: 1.55 letterSpacing: 0
rounded: none: 0px control: 8px surface: 12px feature: 16px pill: 9999px
spacing: row: 8px stack: 12px block: 20px group: 32px page: 28px
measure: reading: 720px form: 640px page: 1080px
elevation: flat: none rim: "inset 0 1px 0 rgb(var(--sheen-rgb) / 0.07)" float: "0 12px 32px -8px rgb(var(--scrim-rgb) / 0.55), 0 0 0 1px hsl(var(--border-strong))"
components: app-room: backgroundColor: "{colors.dark-room}" textColor: "{colors.dark-ink}" typography: "{typography.body}" padding: 0 nav-rail: backgroundColor: "{colors.dark-rail}" textColor: "{colors.dark-ink}" typography: "{typography.label}" padding: "{spacing.row}" border-right: "1px solid {colors.dark-rim}" nav-row: backgroundColor: transparent textColor: "{colors.dark-ink}" typography: "{typography.label}" rounded: "{rounded.control}" padding: "10px 12px" height: 40px nav-row-hover: backgroundColor: "{colors.dark-object}" textColor: "{colors.dark-ink}" rounded: "{rounded.control}" nav-row-selected: backgroundColor: "{colors.dark-lift}" textColor: "{colors.dark-ink-strong}" rounded: "{rounded.control}" card: backgroundColor: "{colors.dark-object}" textColor: "{colors.dark-ink}" typography: "{typography.body}" rounded: "{rounded.surface}" padding: "{spacing.block}" border: "1px solid {colors.dark-rim}" elevation: "{elevation.rim}" list-row: backgroundColor: transparent textColor: "{colors.dark-ink}" typography: "{typography.body}" rounded: "{rounded.control}" padding: "12px 14px" list-row-hover: backgroundColor: "{colors.dark-object}" rounded: "{rounded.control}" list-row-selected: backgroundColor: "{colors.dark-lift}" textColor: "{colors.dark-ink-strong}" rounded: "{rounded.control}" tile: backgroundColor: "{colors.dark-lift}" textColor: "{colors.dark-ink}" typography: "{typography.numeral}" rounded: "{rounded.control}" padding: "16px" bubble-assistant: backgroundColor: "{colors.dark-object}" textColor: "{colors.dark-ink}" typography: "{typography.reading}" rounded: "{rounded.surface}" padding: "14px 18px" bubble-user: backgroundColor: "{colors.dark-speaker}" textColor: "{colors.dark-ink-strong}" typography: "{typography.reading}" rounded: "{rounded.surface}" padding: "14px 18px" composer: backgroundColor: "{colors.dark-object}" textColor: "{colors.dark-ink}" typography: "{typography.reading}" rounded: "{rounded.feature}" padding: "14px 16px" border: "1px solid {colors.dark-rim-strong}" elevation: "{elevation.rim}" input: backgroundColor: "{colors.dark-lift}" textColor: "{colors.dark-ink}" typography: "{typography.body}" rounded: "{rounded.control}" padding: "9px 12px" height: 36px button-primary: backgroundColor: "{colors.dark-fill}" textColor: "{colors.dark-on-fill}" typography: "{typography.label}" rounded: "{rounded.control}" padding: "8px 16px" height: 36px button-secondary: backgroundColor: "{colors.dark-lift}" textColor: "{colors.dark-ink}" typography: "{typography.label}" rounded: "{rounded.control}" padding: "8px 16px" height: 36px button-ghost: backgroundColor: transparent textColor: "{colors.dark-ink-meta}" typography: "{typography.label}" rounded: "{rounded.control}" padding: "8px 12px" height: 36px chip: backgroundColor: "{colors.dark-lift}" textColor: "{colors.dark-ink-meta}" typography: "{typography.meta}" rounded: "{rounded.pill}" padding: "3px 10px" identity-avatar: backgroundColor: derived-from-name textColor: "{colors.dark-ink-strong}" typography: "{typography.title}" rounded: "{rounded.pill}" size: 36px nav-row-selected-bar: backgroundColor: "{colors.dark-signal}" width: 2px link: textColor: "{colors.dark-signal}" typography: "{typography.body}" badge-info: backgroundColor: "{colors.dark-info}" textColor: "{colors.dark-on-fill}" typography: "{typography.micro}" rounded: "{rounded.pill}" diff-line-add: backgroundColor: "{colors.dark-diff-add-ground}" textColor: "{colors.dark-diff-add-ink}" typography: "{typography.code}" diff-line-del: backgroundColor: "{colors.dark-diff-del-ground}" textColor: "{colors.dark-diff-del-ink}" typography: "{typography.code}" status-dot-live: backgroundColor: "{colors.dark-life}" rounded: "{rounded.pill}" size: 8px status-dot-fault: backgroundColor: "{colors.dark-fault}" rounded: "{rounded.pill}" size: 8px status-dot-idle: backgroundColor: "{colors.dark-ink-faint}" rounded: "{rounded.pill}" size: 8px popover: backgroundColor: "{colors.dark-float}" textColor: "{colors.dark-ink}" typography: "{typography.body}" rounded: "{rounded.surface}" padding: "{spacing.row}" elevation: "{elevation.float}" table-head: backgroundColor: "{colors.dark-lift}" textColor: "{colors.dark-ink-meta}" typography: "{typography.meta}" padding: "10px 14px" section-header: backgroundColor: transparent textColor: "{colors.dark-ink-strong}" typography: "{typography.page}" padding: "{spacing.page}" empty-state: backgroundColor: "{colors.dark-object}" textColor: "{colors.dark-ink-meta}" typography: "{typography.body}" rounded: "{rounded.surface}" padding: "40px {spacing.block}" border: "1px solid {colors.dark-rim}" skeleton: backgroundColor: "rgb(var(--sheen-rgb) / 0.07)" rounded: "{rounded.control}" selection: backgroundColor: "rgb(var(--sheen-rgb) / 0.22)" textColor: "{colors.dark-ink-strong}"
Overview
This document specifies the Dodaios desktop application through surface roles, text hierarchy, semantic colours and interaction states.
- Visible structure. The dark room uses
#121212; cards and composers have a fill and a visible rim. - Readable text. Body text uses
#F0F0F0, with#A3A3A3for secondary information. Placeholder and disabled text have their own role. - Bundled type. Inter Variable, JetBrains Mono and Space Grotesk provide consistent metrics when the application starts offline.
- Type floor. Use the
microstep for the smallest labels: 11 px. - Meaningful colour. Neutral surfaces carry the structure. Colour marks actions, state, identity, diff changes and run-step families.
Colors
The surface ladder
Six roles. Their brightness inverts between themes; their role never changes. Nothing in the product invents a seventh surface, and no surface is produced by multiplying a token by an opacity.
| Role | Job | Dark | Light |
|---|---|---|---|
room |
The page and every full-bleed region. Most of the window. | #121212 |
#F7F7F4 |
rail |
The navigation column and other standing chrome. Edged with rim. |
#171717 |
#F1F0EA |
object |
A card, bubble, composer, panel or hovered row. Content-sized only. | #1F1F1F |
#FFFFFF |
lift |
The answer to a pointer: hover on an object, a selected row, a field, a tile. | #292929 |
#E6E5E0 |
speaker |
The user's own turn in a conversation. A quiet fill with strong ink — not a slab. | #2E2E2E |
#E6E5E0 |
float |
Menus, dialogs, tooltips — surfaces that leave the plane. | #303030 |
#FFFFFF + float shadow |
Steps are 5–7 byte-values apart at the bottom of the ladder, which is the
smallest distance that survives an uncalibrated monitor. Lift still scales
inversely with area: a surface wider than ~720 px stays at room or rail.
The user's bubble has a quiet surface fill; strong ink carries the emphasis.
Rims
Two values, and both must be visible on the surface they enclose. A rim the eye cannot find is not restraint; it is a missing edge.
| Token | Job | Dark | Light | Visible on |
|---|---|---|---|---|
rim |
Card edges, dividers, table rules, the rail's edge. | #2B2B2B |
#DFDDD5 |
room, rail and object |
rim-strong |
Composer outline, floating layers, focus rings, scrollbar thumbs. | #404040 |
#BDBAB0 |
everything up to float |
#2B2B2B on #121212 is approximately white at 10 %;
#404040 is approximately white at 19 %.
A fill and a rim together are the normal case. Keep the object's surface distinct and its boundary visible against the surrounding room.
Ink
Four steps, each with one job.
| Token | Job | Dark | Light | On object |
|---|---|---|---|---|
ink-strong |
Headings, headline numbers, the selected row's label. | #FAFAFA |
#171610 |
15.9 : 1 |
ink |
Body, labels, running text, list titles. | #F0F0F0 |
#26251E |
14.5 : 1 |
ink-meta |
Timestamps, secondary lines, table heads, captions. | #A3A3A3 |
#66635A |
6.6 : 1 |
ink-faint |
Placeholders and disabled text only. Never information. | #7A7A7A |
#8B877C |
3.7 : 1 |
fill (#FFFFFF dark, #26251E light) is the accent. It paints buttons,
marks, active indicators and focus rings. It never paints text, a byline, or
a decorative icon.
Body ink stays below pure white at #F0F0F0. Secondary information uses
the brighter ink-meta role; reserve ink-faint for placeholders and
disabled controls.
Colour has jobs
Neutral greys carry the structure. Colour communicates meaning through one signal hue, four semantic tones and coloured diffs. Keep the hues visually balanced across the interface.
| Token | Job | Dark | Light |
|---|---|---|---|
signal (--accent) |
Links, focus ring token, the active nav row's leading bar, the install caret, prose links. Press this / follow this. | #81A1C1 |
#2778C1 |
life (--success) |
Running, live, connected, passed, progress. | #3FA266 |
#007041 |
fault (--destructive) |
Failed, blocked, error, destructive action. | #E34671 |
#BE1744 |
degraded (--warning) |
Stale, modified, partial, needs attention. | #F1B467 |
#A46700 |
info (--info) |
Counts, new items, hints — "note this" without "something is wrong". | #88C0D0 |
#176C74 |
--primary supplies the neutral fill for the primary button, marks and orb
ring. signal identifies links and interactive cues rather than button fills.
Binding rules. A status may never be encoded as ink or fill. A status
ramp may never render "ok" dimmer than "unknown". A success state must
actually use life. And a hue is never decorative: if an element is coloured,
the colour must be readable as one of the five jobs above.
Diffs
An added line uses green ink on green at 18 %; a removed line uses rose ink on rose at 20 %. Keep the text readable against both backgrounds.
The run graph
Eleven step families use distinct semantic colours: lavender reasoning, cyan shell and web, amber writes and deliverables, sky search, mauve integrations, pink sub-agents, blue ignition, green landing and neutral unknown.
Identity
Every conversation, agent, provider and person carries a coloured identity mark: a real vendor logo where one exists (kept in full colour — the documented exception to the neutral rule), otherwise a round avatar whose hue is derived deterministically from the name. Never a grey placeholder, never a monogram on a neutral disc. Identity hues sit outside the status palette and are never read as state.
Selection
Dragging across text answers in the theme's own material — sheen at 22 % —
never the engine's default blue. Selection is not a job for signal. It was the one saturated slab a
black-and-white product showed every time someone selected a sentence.
Typography
Families
| Role | Family | Ships as |
|---|---|---|
| Interface | Inter Variable | @fontsource-variable/inter, one woff2 per script subset, every weight |
| Display | Space Grotesk | 500 / 600 / 700 static cuts. Section titles and headline numbers only. |
| Code | JetBrains Mono | 400 / 500 / 600 / 700 static cuts. Every code, terminal, path and transcript surface. |
All three are bundled by Vite and fingerprinted into dist/assets. There is
no remote font request anywhere in the product. Licences are SIL OFL 1.1 and
are listed in public/THIRD_PARTY_NOTICES.txt.
Inter is set with cv02 cv03 cv04 cv11 (open shapes, single-storey a) and
−0.01 em tracking at interface sizes. reading and code reset tracking
to 0 through their own declarations.
The scale
Seven steps plus one weight variant. There is nothing between them and nothing below them.
| Token | Size / Weight | Line height | Use |
|---|---|---|---|
display |
24 / 600 | 1.2 | Section title, headline number |
page |
20 / 600 | 1.3 | Page heading |
title |
15 / 600 | 1.4 | Card title, list-row title, group label |
reading |
15 / 400 | 1.6 | Chat, transcripts, documents, prose |
body |
14 / 400 | 1.5 | Default interface text, controls |
label |
14 / 500 | 1.5 | Navigation rows and buttons. |
meta |
13 / 400 | 1.45 | Timestamps, captions, secondary lines |
micro |
11 / 500 | 1.4 | Badges and dense table cells. Hard floor. |
11 px is the floor. Do not use text-[10px], text-[9px] or
text-[8px] for interface text.
Principles
- Weight is hierarchy. 400 for reading and meta, 500 for anything a person navigates or presses, 600 for titles. A navigation column set entirely in 400 grey is a list of ghosts.
- No tiny all-caps labels outside a badge.
- Line height comes from the scale, never from a
leading-*class. - Tabular numerals wherever digits align.
Layout
Four named spacing steps and three measures, unchanged from 2.0:
| Token | Value | Use |
|---|---|---|
row |
8px | Inside a row: icon to label, chip to chip |
stack |
12px | Between siblings in a list or form |
block |
20px | Card padding, between related blocks |
group |
32px | Between groups in a section |
page |
28px | Section outer padding |
| Measure | Value | Use |
|---|---|---|
reading |
720px | Chat, transcripts, prose |
form |
640px | Settings groups, single-column forms |
page |
1080px | Dashboards, tables, card grids |
A section is designed by subtraction. Remove every wrapper that only
holds one other thing, every label that repeats its value, every count nobody
acts on. The target is ≥ 60 % of a section's pixels at room or rail —
but what remains must have edges.
Elevation
Three levels. Depth is carried by fill and rim; shadow only when floating.
| Level | Treatment | Use |
|---|---|---|
| Flat | No shadow. Its own surface token. | Rows, tiles, chips — everything in the plane |
| Rim | inset 0 1px 0 sheen at 7 % plus a rim hairline |
Cards, bubbles, composers. A top edge catching light and a drawn edge. |
| Float | Real shadow + rim-strong ring |
Menus, dialogs, tooltips only |
No decorative glows. A bloom is additive light standing in for a fill that should have been there.
Shapes
| Token | Value | Use |
|---|---|---|
control |
8px | Rows, buttons, inputs, tiles, menu items |
surface |
12px | Cards, bubbles, panes, popovers |
feature |
16px | Composers and large feature cards |
pill |
9999px | Chips, badges, avatars, status dots |
The composer uses feature: a 16 px radius within the 720 px reading measure.
The theme never changes an element's shape — only its value.
Interaction
One ladder, one recipe. It only ever goes up.
| State | Treatment |
|---|---|
| Rest | The element's own surface token |
| Hover | One step up the ladder (object → lift) |
| Selected | lift plus ink-strong on the label |
| Focus | 2px rim-strong ring. Never a third fill. |
| Pressed | scale(0.98), 120ms |
Selection is a full-width rounded fill on the whole row, inset from the
column edge. Scrollbar thumbs are rim-strong; a thumb at rim was a thumb
nobody could find. Transitions are 120 ms on fills and 160 ms on transforms.
Everything respects prefers-reduced-motion.
Nesting
A child surface steps up, never down. It is a hard error for an element to render darker than its parent in dark mode.
| Parent | A nested well, tile, field or table head takes |
|---|---|
room |
rail or object |
rail |
object |
object |
lift |
lift |
float, or no surface at all |
When the ladder runs out, stop nesting.
States
Every section owns four states, and all four are designed.
- Loading renders the real container at its real height with skeleton
bars at
sheen7 %. Never a centred grey word in a void, never invented zeros. - Empty is a designed surface —
objectwith arim— with one sentence saying what will appear here and one action that makes it appear. - Error says what failed and what to do. It uses
faulton a normal surface, never a red-washed panel. - Populated is the state everything else in this document describes.
Do's and Don'ts
Do
- Give every object a fill and an edge. Fill first, rim second, shadow only when floating.
- Keep the room at
room. Lift only what is sized to its content. - Set navigation and buttons in
label(500), notbody(400). - Spend
lifegreen on anything that is actually running. - Cap ink below white and reserve
fillfor fills. - Bound the measure IN THE VIEW, on the element that needs it — a prose column, a form, a card grid. Never in the shell: a shell-level 1080 px column (tried 2026-09-01, reverted the same evening) squeezed the wiki graph into a thumbnail on a 4K window, tore sub-navigation columns off the left edge and centred every form in a sea of black. Graphs, terminals, boards and tables keep the whole window.
- Remove before you restyle — and check what is left still has edges.
Don't
- Don't express depth with opacity.
bg-card/40as a resting ground is a defect; depth is a named token. - Don't write a literal colour anywhere except
terminalThemes.ts, the one sanctioned exception (xterm needs resolved strings). - Don't tune a rim until it disappears. If it cannot be seen on the surface it encloses, it is not a rim.
- Don't set a status in
inkorfill, and never let "ok" be quieter than "unknown". - Don't colour anything that is not one of the five jobs. A hue with no meaning is noise; five hues with meaning are the difference between a wireframe and a product.
- Don't use tiny uppercase labels. Don't go below 11 px.
- Don't add a shadow to anything that is not floating.
- Don't fetch a font from a remote host. Ever.
Light mode
Light is the same system read the other way: warm paper (#F7F7F4) and warm
near-black ink (#26251E). Objects rise toward white, interaction answers
downward into warm grey, rims darken instead of lightening, and fill
becomes ink on paper. The 3.0 changes on paper are the same changes as on
graphite: rim down to #DFDDD5 so it reads on white cards, ink-meta
down to #66635A (6.6 : 1 on paper), and the user bubble becomes a quiet
lift fill with strong ink rather than a black slab.
The five colour jobs keep their meaning between themes. Light mode uses
#2778C1, #007041, #BE1744, #A46700 and #176C74 respectively.
The Agentic IDE panes
The pane family (terminal shells, chat stage, rail, toolbar) reads the same
ladder re-derived per appearance in terminalThemes.ts, because a light pane
inside a dark app is a supported combination and xterm cannot read a CSS
token. The values there are this document's values: dark shell over #121212,
rims at white 12 %, float #303030, ink #F0F0F0 / #A3A3A3 / #7A7A7A.
The 16 ANSI slots coordinate terminal output with the app's semantic palette.
Each appearance defines its own normal and bright values in terminalThemes.ts.
Enforcement
These rules are checked, not remembered. Each has a gate in scripts/ci/
alongside the existing German and private-key gates.
| Gate | Fails on |
|---|---|
| No literal colour | A hex, rgb(), or Tailwind palette class in .tsx, .ts or .css outside terminalThemes.ts |
| No opacity hierarchy | bg-(card|background|muted)/[0-9] or bg-sheen/ used as a resting fill |
| No negative hover | hover:bg-background/ |
| Type floor | text-[10px] or smaller |
| No admin caps | uppercase in views/ outside a badge |
| No remote fonts | fonts.googleapis.com or any @import url(http in .css |
Known gaps
- Motion is specified only as durations. A typing indicator, a streaming cursor and a run-in-progress pulse are still not designed; "dead" for an interactive app is partly that nothing moves.
- The navigation column lists ~20 sections at one weight and one indent. This version makes them legible; grouping them is a product decision the theme cannot make.
- Icon size and stroke weight are not yet audited across the view tree.
- The wallpaper feature's readability floors were derived on the 2.0 ladder and have not been re-tuned.