Skip to content

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.

9.5 KB
Raw Blame

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.

Dodaios logo

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 (#3D8BFF dark / #096CDC light) is the only hue that means "interactive or selected": links, focus rings, the active nav row's bar, selected rows (--accent at 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 by scripts/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.html is a fully reproducible pure-CSS/SVG treatment of the same wordmark; pwsh assets/brand/render.ps1 rasterizes it to banner-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/