From 36b4001f4526b60f1c9b67a4a34596e5ad2bcca1 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Thu, 18 Jun 2026 02:52:35 +0300 Subject: feat: sync theme with host appearance refs #675 --- docs/next/website/src/content/docs/configuration.mdx | 12 ++++++++++++ 1 file changed, 12 insertions(+) (limited to 'docs/next/website/src/content') diff --git a/docs/next/website/src/content/docs/configuration.mdx b/docs/next/website/src/content/docs/configuration.mdx index b879af7f..987b6973 100644 --- a/docs/next/website/src/content/docs/configuration.mdx +++ b/docs/next/website/src/content/docs/configuration.mdx @@ -257,6 +257,18 @@ Built-in themes: Use `terminal` when you want Herdr UI colors to follow your host terminal's ANSI palette. +To let Herdr switch its own UI theme when the host terminal reports a light/dark appearance change, enable theme auto-switching: + +```toml +[theme] +name = "catppuccin" +auto_switch = true +light_name = "catppuccin-latte" +dark_name = "catppuccin" +``` + +`auto_switch` defaults to `false`, so existing theme configs keep manual behavior. If `light_name` or `dark_name` is omitted, Herdr uses the matching built-in sibling for the configured `name` when one exists, such as `tokyo-night`/`tokyo-night-day` or `gruvbox`/`gruvbox-light`. Manual theme selection in Settings disables `auto_switch`. + You can override individual colors: ```toml -- cgit v1.2.3