Struct Theme 

pub struct Theme {

    pub name: String,
    pub bg: ThemeColor,
    pub bg_hard: ThemeColor,
    pub bg_soft: ThemeColor,
    pub bg_panel: ThemeColor,
    pub selection_bg: ThemeColor,
    pub fg: ThemeColor,
    pub fg_bright: ThemeColor,
    pub fg_secondary: ThemeColor,
    pub gray: ThemeColor,
    pub selection_fg: ThemeColor,
    pub border_dim: ThemeColor,
    pub focus_border: ThemeColor,
    pub accent: ThemeColor,
    pub cursor: ThemeColor,
    pub red: ThemeColor,
    pub green: ThemeColor,
    pub yellow: ThemeColor,
    pub blue: ThemeColor,
    pub purple: ThemeColor,
    pub aqua: ThemeColor,
    pub orange: ThemeColor,
    pub color_directory: ThemeColor,
    pub color_journal_date: ThemeColor,
    pub color_search_match: ThemeColor,
    pub color_tag: ThemeColor,
    pub blockquote_bar: ThemeColor,
    pub code_bg: ThemeColor,
}

Theme for the TUI application.

Fields are named after the UI roles they fill, making it straightforward to map any popular terminal color scheme (Gruvbox, Catppuccin, Tokyo Night, …) to this struct. Custom themes can be placed as .toml files in the themes config directory and will be loaded automatically at startup.

Example theme file (~/.config/kimun/themes/mytheme.toml)

name = "My Theme"
bg               = "#1e1e2e"
bg_hard          = "#11111b"
bg_soft          = "#313244"
bg_panel         = "#181825"
selection_bg      = "#313244"
fg               = "#cdd6f4"
fg_bright        = "#f5e0dc"
fg_secondary     = "#a6adc8"
gray         = "#6c7086"
selection_fg      = "#cdd6f4"
border_dim           = "#45475a"
focus_border   = "#89b4fa"
accent           = "#89b4fa"
cursor           = "#f5e0dc"
red              = "#f38ba8"
green            = "#a6e3a1"
yellow           = "#f9e2af"
blue             = "#89b4fa"
purple           = "#cba6f7"
aqua             = "#94e2d5"
orange           = "#fab387"
color_directory  = "#89dceb"
color_journal_date = "#94e2d5"
color_search_match = "#a6e3a1"
color_tag        = "#fab387"
blockquote_bar   = "#cba6f7"
code_bg          = "#181825"

Roles introduced after a theme file was written may be omitted — they are derived from the closest sibling role (see [ThemeToml]).

Fields

name: String

bg: ThemeColor

Main/editor background.

bg_hard: ThemeColor

Hard-contrast background: modals and input fields.

bg_soft: ThemeColor

Soft background: alternating rows, horizontal rules.

bg_panel: ThemeColor

Sidebar / panel background (usually slightly offset from bg).

selection_bg: ThemeColor

Background of the currently selected row in lists.

fg: ThemeColor

Primary text color.

fg_bright: ThemeColor

Bright/high-contrast text: titles, headings.

fg_secondary: ThemeColor

Secondary text: filenames, metadata, subdued hints.

gray: ThemeColor

Very dim text: placeholders, separators, disabled items.

selection_fg: ThemeColor

Text color of a selected/highlighted row (often brighter than fg).

border_dim: ThemeColor

Default (unfocused) border color.

focus_border: ThemeColor

Border color when the pane has keyboard focus.

accent: ThemeColor

Primary accent: title bars, active markers, cursor highlights.

cursor: ThemeColor

Block-cursor color in text fields.

red: ThemeColor

Errors, destructive actions, query negation.

green: ThemeColor

Success / OK states.

yellow: ThemeColor

Warnings, field keys, keycaps.

blue: ThemeColor

Wikilink targets.

purple: ThemeColor

Numbers and date literals.

aqua: ThemeColor

Tags, links, group labels.

orange: ThemeColor

Operators and strong accents.

color_directory: ThemeColor

Color used for directory entries in the file list.

color_journal_date: ThemeColor

Color for the journal-date annotation line in journal entries.

color_search_match: ThemeColor

Color for highlighted search-match text.

color_tag: ThemeColor

Color for #hashtag label spans in the editor.

blockquote_bar: ThemeColor

Color of the │ blockquote bar drawn in place of > markers.

code_bg: ThemeColor

Background of fenced and indented code blocks (the “code box”). Inline code uses selection_bg, not this.

Implementations

impl Theme

pub fn builtins() -> Vec<Theme>

Every built-in theme, in presentation order.

pub fn gruvbox_dark() -> Self

pub fn gruvbox_light() -> Self

pub fn catppuccin_mocha() -> Self

pub fn catppuccin_latte() -> Self

pub fn tokyo_night() -> Self

pub fn tokyo_night_storm() -> Self

pub fn solarized_dark() -> Self

pub fn solarized_light() -> Self

pub fn nord() -> Self

pub fn dracula() -> Self

pub fn alucard() -> Self

Alucard is Dracula’s official light variant.

pub fn one_dark() -> Self

pub fn one_light() -> Self

pub fn monokai() -> Self

pub fn everforest_dark() -> Self

pub fn everforest_light() -> Self

pub fn rose_pine() -> Self

pub fn rose_pine_dawn() -> Self

Dawn is Rosé Pine’s light variant. Note bg_panel (surface) is lighter than bg (base) — that is the official palette layering.

pub fn kanagawa_wave() -> Self

pub fn kanagawa_lotus() -> Self

Lotus is Kanagawa’s light variant.

pub fn ansi() -> Self

Uses the terminal’s 16 ANSI colors so the theme adapts to whatever palette the user has configured in their terminal emulator. Works for both light and dark terminal palettes because backgrounds and primary foregrounds use Reset (the terminal’s defaults) and accents are chromatic ANSI slots whose hue is stable across palettes.

impl Theme

pub fn adapt_to_terminal(self) -> Theme

Adapt this theme to the terminal the process is running in.

The one entry point display paths should use — AppSettings::get_theme() and the settings-screen live preview both funnel through it.

pub fn adapt(self, depth: ColorDepth) -> Theme

Return a copy of this theme adapted to the given color depth.

Truecolor terminals get the theme unchanged.

impl Theme

pub fn border_style(&self, focused: bool) -> Style

Returns the appropriate border style depending on focus state.

pub fn base_style(&self) -> Style

Base style for most surfaces: theme fg on theme bg.

pub fn panel_style(&self) -> Style

Panel style for sidebars and panels: theme fg on bg_panel.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Theme

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Theme

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Theme

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Theme

fn eq(&self, other: &Theme) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Theme

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Theme