Customize
Colours and presets
Set your brand colour, pick a palette, and override any individual design token.
Colour changes apply on the next deepdoc serve. No regeneration, no LLM
calls — the site is rebuilt from your saved plan.

Your brand colour
Three values, and each one does a specific job:
site:
colors:
primary: "#7c3aed" # sidebar highlight, links, active states
light: "#c4b5fd" # the accent in dark mode
dark: "#5b21b6" # link hover in light mode
Then:
deepdoc serve
Applied .deepdoc.yaml changes (no regeneration, no LLM calls): colors
That line only prints when something actually changed, so it doubles as confirmation your edit was picked up.
Colours accept #rgb or #rrggbb. Anything else warns and falls back rather
than failing your build:
site.colors.primary: 'purple' is not a hex colour (expected #rgb or #rrggbb) — using #eb3e25.
Palettes
A preset replaces the whole page palette — backgrounds, borders, muted text — not just the accent.
site:
theme:
preset: ocean

Seven palettes ship:
| Preset | Character |
|---|---|
neutral | Greys. The default look. |
black | Higher contrast, near-black in dark mode. |
vitepress | Clean white with a blue primary. |
ocean | Deep navy in dark mode. |
catppuccin | Soft blue-grey with violet accents. |
dusk | Muted lavender, rose-pink primary. |
purple | Lilac page background. The loudest. |
Leave preset empty for DeepDoc’s own palette. An unknown name warns and falls
back — it never breaks the build.
Overriding individual tokens
When a preset is close but not right, override single design tokens. This is the escape hatch — anything the named settings do not cover.
site:
theme:
preset: ocean
tokens:
light:
background: "#ffffff"
border: "#e5e7eb"
dark:
background: "#0b0b0d"
Twenty tokens are available, light and dark independently:
All 20 design tokens
background · foreground · muted · muted-foreground · popover ·
popover-foreground · card · card-foreground · border · primary ·
primary-foreground · secondary · secondary-foreground · accent ·
accent-foreground · ring · error · warning · success · info
Write them bare, as above. The --color-fd- prefix is accepted and
stripped, so --color-fd-border and border both work. An unknown name
warns and is ignored.
Which wins
Three layers, lowest to highest:
So a preset plus a tokens.light.background gives you that palette with your
own page background, and nothing else changes.