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.
Brand Guidelines
The visual language of Dodaios: a neutral, cool-black interface with one restrained accent, the hooded-figure logo, and a distressed wordmark. The goal is confident and engineered, never noisy or playful.
Color
Pure neutral in both modes — every surface, rim and ink is r = g = b. Elevation is a
surface colour one step lighter than the one under it (canvas → sidebar → card → popover),
never a shadow. One accent (blue) marks links, focus rings, the active nav row, selected
states, progress bars and informational status. Green, amber and red are status only.
| Role | Dark | Light |
|---|---|---|
Canvas (--background) |
#0A0A0A |
#FFFFFF |
Sidebar (--sidebar) |
#0F0F0F |
#FAFAFA |
Card (--card) |
#171717 |
#FFFFFF |
Popover (--popover) |
#1C1C1C |
#FFFFFF |
Hover / input (--secondary, --muted, --input) |
#1F1F1F |
#F5F5F5 |
Raised (--surface-raised) |
#262626 |
#EDEDED |
Hairline (--border) |
#262626 |
#DBDBDB |
Strong rim (--border-strong) |
#383838 |
#BDBDBD |
Foreground (--foreground) |
#FAFAFA |
#171717 |
Secondary ink (--foreground-secondary) |
#B8B8B8 |
#424242 |
Muted ink (--muted-foreground) |
#A1A1A1 |
#545454 |
Faint ink (--foreground-faint) |
#7A7A7A |
#6B6B6B |
Primary fill (--primary) |
#FAFAFA |
#171717 |
Accent (--accent) |
#3D8BFF |
#096CDC |
Success (--success) |
#22C35E |
#15803D |
Warning (--warning) |
#F59E0B |
#A95C04 |
Destructive (--destructive) |
#DF3A3A |
#C52020 |
These are the exact tokens from the desktop app
(dodaios/ui/web/frontend/src/index.css). dodaios/ui/theme.py (WINDOW_BACKGROUND),
the boot splash tokens in frontend/index.html (--jbs-*), the README, and any brand
asset must stay on the same values so nothing drifts.
Rules
- Neutral, both modes. Surfaces, rims and ink carry zero saturation. Dark is a
cool black room (
#0A0A0A) with objects one step lighter each; light is the same ladder inverted on white. No warm cast, no blue-black, no cream. - One accent. Blue (
#3D8BFFdark /#096CDClight) is the only hue that means "interactive or selected": links, focus rings, the active nav row's bar, selected rows (--accentat 12 % as the wash), progress bars, informational callouts. It never fills a primary button — that stays white on dark and black on light. - Status colours are for status. Green for live dots and "running", amber for paused or quota, red for failed and destructive actions. Provider logos keep their real colours, the sixteen ANSI slots stay coloured, diffs stay green/red.
- Elevation by surface, not shadow. Shadows exist only on popovers, dialogs and the composer. No glows.
- Both modes, always. A colour comes from a theme token or from the per-appearance
tables in
terminalThemes.ts. Never hardcode one mode's value. - The logo is the hooded figure in black and white: black ink on a white tile, white ink
on dark surfaces. It is the primary Dodaios logo; no other mark stands in for it. Its single source is
assets/brand/dodaios-logo.svg; every icon is rendered from it byscripts/make_app_icon.py. - Rasters convert on max(r, g, b), the orb on luma. That is what keeps a mark legible after it loses its colour.
Typography
One family. Six sizes. Three weights.
| Use | Typeface | Notes |
|---|---|---|
| Interface and display | Inter Variable | 400 body, 500 labels / nav / buttons, 600 titles. Display text is the same family with -0.02em tracking. No 700 in UI text. |
| Code / mono / tagline | JetBrains Mono (500) | Letter-spaced caps for taglines and labels |
| Step | Size / line | Use |
|---|---|---|
text-xs |
12 / 16 | badges, keyboard hints, table meta — the only 12 px |
text-sm |
13 / 18 | dense table cells, chip labels, code |
text-base |
14 / 20 | body, sidebar items, inputs, buttons |
text-lg |
16 / 24 | card and list titles, composer text |
text-xl |
20 / 28 | view titles |
text-2xl |
28 / 34 | home greeting only |
Spacing sits on a 4 px grid. Radii: 4 px badges, 8 px buttons / inputs / chips / menu items, 12 px cards / panels / dialogs, 16 px only the composer and hero cards, full only avatars and status dots. No pill-shaped buttons or chips.
Both families ship inside the app bundle (@fontsource packages, SIL OFL 1.1); nothing is
fetched from a remote host.
The wordmark
The wordmark is the word DODAIOS as an embossed, beveled metallic-gold wordmark on matte black — chunky geometric capitals with 3D bevels, specular highlights, a warm golden bloom, and faint embers. It should read like forged gold, not flat text.
The banner files below still spell the former product name; regenerate them with the current name before using the banner anywhere.
- Live banner:
../assets/brand/banner.png— a high-resolution generated raster (2172×724, 3:1). - CSS fallback:
../assets/brand/banner.htmlis a fully reproducible pure-CSS/SVG treatment of the same wordmark;pwsh assets/brand/render.ps1rasterizes it tobanner-css.png. Use it only where a generated raster isn't available.
Do
- Keep clear space around the wordmark of at least the cap-height on every side.
- Keep it on a dark, low-detail background so the glow reads.
- Keep the distress subtle — legibility first.
Don't
- Don't recolor it (no blue, no white-only, no rainbow).
- Don't crank the glitch until letters are hard to read — it's seasoning, not the dish.
- Don't place it on a busy photo without a dark scrim behind it.
- Don't stretch, condense, or rotate it.
Voice & tone
Write like a senior engineer who respects the reader's time.
- Honest over hype. State what's live, what's pending, and what's unverified — the way the product's own verification badges do. No "blazingly fast", no exclamation storms.
- Concrete over abstract. Show the mechanism, not the marketing.
- Sparing with emoji. A single functional marker is fine; a wall of them is not.
- English for artifacts (code, docs, commits); the assistant speaks de/en/es at runtime, but everything written into the repo is English.
Asset index
| Asset | Path |
|---|---|
| Hero banner (live) | assets/brand/banner.png |
| Hero banner (CSS fallback source) | assets/brand/banner.html → banner-css.png |
| Banner render script | assets/brand/render.ps1 |
| Product Orb | dodaios/ui/web/frontend/public/hero-orb.png |
| Logo (vector source) | assets/brand/dodaios-logo.svg |
| Logo (raster master, 1254 px) | assets/brand/dodaios-logo.png |
| App icon (rendered) | assets/icons/dodaios.ico, dodaios-1024.png, dodaios.icns |
| App screenshots | assets/screenshots/ |