Customize

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.

A generated site using the default palette

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

The same site with preset: ocean

Seven palettes ship:

PresetCharacter
neutralGreys. The default look.
blackHigher contrast, near-black in dark mode.
vitepressClean white with a blue primary.
oceanDeep navy in dark mode.
catppuccinSoft blue-grey with violet accents.
duskMuted lavender, rose-pink primary.
purpleLilac 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:

Preset — sets the whole palette.
Your brand colours — override the accent on top of the preset.
Token overrides — the final word, always win.

So a preset plus a tokens.light.background gives you that palette with your own page background, and nothing else changes.

Edit this page on GitHub