Themes

Switch the look of your docs without touching CSS.

Themes

Pick a theme by setting theme in docs.json:

json
{ "theme": "tang" }

Built-in themes

ThemeVibe
tangDefault. Clean, Mintlify-Mint-inspired.
pithEditorial. Serif headings, cream background.
geistVercel-flavored, system sans, dense.
pipMinimal, ultra-light chrome.
readableHigh-contrast, generous spacing.

Mintlify aliases (mint, maple, palm, willow, linden, almond, aspen, luma, sequoia) all map to tang so existing docs.json files just work.

Tweak the accent

json
{
  "theme": "tang",
  "colors": {
    "primary": "#0ea5e9",
    "light": "#38bdf8",
    "dark": "#0284c7"
  }
}

primary is the only required color. light and dark override the accent in light/dark mode respectively.

Add a theme

bash
tangly add theme pith

Pulls the theme into your project’s deps. Switch theme in docs.json and reload.

Eject

If you outgrow theme tokens and want full control:

bash
tangly eject

Copies the active theme into your repo so you can edit components and styles directly.

Live docs

Full reference: tangly.dev/guides/themes.

↑↓ navigate open esc close