Struct Theme 

pub struct Theme {

    pub name: String,
    pub background: Option<Color>,
    pub surface: Option<Color>,
    pub foreground: Color,
    pub muted: Color,
    pub disabled: Color,
    pub border: Color,
    pub border_focused: Color,
    pub title: Color,
    pub primary: Color,
    pub secondary: Color,
    pub accent: Color,
    pub success: Color,
    pub warning: Color,
    pub error: Color,
    pub info: Color,
    pub selection_bg: Color,
    pub selection_fg: Color,
    pub highlight: Color,
    pub palette: Vec<Color>,
    pub bull: Color,
    pub bear: Color,
    pub neutral: Color,
    pub axis: Color,
    pub grid: Color,
    pub crosshair: Color,
    pub tooltip_fg: Color,
    pub tooltip_bg: Color,
}

A named set of colors shared by every widget of an application.

The first group of fields (foreground … highlight) is the general UI vocabulary; the second group (palette … tooltip_bg) are the data visualisation colors, kept under the same names tui-chart used so migrating is a rename of the import.

With the serde feature a theme (de)serialises as a flat map of "#rrggbb" / color-name strings; missing keys fall back to Theme::default, and unset background/surface are omitted.

Fields

name: String

Display name (also used by Theme::next / Theme::prev).

background: Option<Color>

Background fill; None keeps the terminal background.

surface: Option<Color>

Panel / card background; None means “same as background”.

foreground: Color

Default text color.

muted: Color

De-emphasised text (hints, tick labels, legends).

disabled: Color

Text of disabled elements.

border: Color

Unfocused border color.

border_focused: Color

Focused border color.

title: Color

Title color.

primary: Color

Main brand / interaction color.

secondary: Color

Secondary brand color.

accent: Color

Accent color (single-series charts, gradients, highlights).

success: Color

Positive status color.

warning: Color

Warning status color.

error: Color

Error status color.

info: Color

Informational status color.

selection_bg: Color

Background of the selected item.

selection_fg: Color

Foreground of the selected item.

highlight: Color

Highlight color (search matches, markers).

palette: Vec<Color>

Series palette (at least 8 colors); series i uses palette[i % len].

bull: Color

“Up” color (bullish candles, bids, increases).

bear: Color

“Down” color (bearish candles, asks, decreases).

neutral: Color

Neutral / total color.

axis: Color

Axis line color.

grid: Color

Grid line color.

crosshair: Color

Crosshair guide line color.

tooltip_fg: Color

Crosshair tooltip text color.

tooltip_bg: Color

Crosshair tooltip background color.

Implementations

impl Theme

pub fn catppuccin_mocha() -> Self

Catppuccin Mocha (dark).

pub fn catppuccin_latte() -> Self

Catppuccin Latte (light).

pub fn dracula() -> Self

Dracula (dark).

pub fn nord() -> Self

Nord (dark, arctic blues).

pub fn gruvbox() -> Self

Gruvbox (dark, warm retro).

pub fn tokyo_night() -> Self

Tokyo Night (dark).

pub fn solarized_dark() -> Self

Solarized Dark.

pub fn solarized_light() -> Self

Solarized Light.

pub fn one_dark() -> Self

One Dark (Atom).

pub fn rose_pine() -> Self

Rosé Pine (dark).

pub fn monokai() -> Self

Monokai (dark).

pub fn default_light() -> Self

Default Light (light, from gitkraft).

pub fn grape() -> Self

Grape (dark, from gitkraft).

pub fn ocean() -> Self

Ocean (dark, from gitkraft).

pub fn sunset() -> Self

Sunset (dark, from gitkraft).

pub fn forest() -> Self

Forest (dark, from gitkraft).

pub fn rose() -> Self

Rose (dark, from gitkraft).

pub fn neon() -> Self

Neon (dark, from gitkraft).

pub fn gruvbox_light() -> Self

Gruvbox Light (light, from gitkraft).

pub fn catppuccin_frappe() -> Self

Catppuccin Frappé (dark, from gitkraft).

pub fn catppuccin_macchiato() -> Self

Catppuccin Macchiato (dark, from gitkraft).

pub fn tokyo_night_storm() -> Self

Tokyo Night Storm (dark, from gitkraft).

pub fn tokyo_night_light() -> Self

Tokyo Night Light (light, from gitkraft).

pub fn kanagawa_wave() -> Self

Kanagawa Wave (dark, from gitkraft).

pub fn kanagawa_dragon() -> Self

Kanagawa Dragon (dark, from gitkraft).

pub fn kanagawa_lotus() -> Self

Kanagawa Lotus (light, from gitkraft).

pub fn moonfly() -> Self

Moonfly (dark, from gitkraft).

pub fn nightfly() -> Self

Nightfly (dark, from gitkraft).

pub fn oxocarbon() -> Self

Oxocarbon (dark, from gitkraft).

pub fn cyberpunk() -> Self

Cyberpunk (dark, from gitkraft).

pub fn rose_pine_moon() -> Self

Rose Pine Moon (dark, from gitkraft).

pub fn rose_pine_dawn() -> Self

Rose Pine Dawn (light, from gitkraft).

pub fn ayu_mirage() -> Self

Ayu Mirage (dark, from gitkraft).

pub fn everforest_dark() -> Self

Everforest Dark (dark, from gitkraft).

pub fn atom_one_light() -> Self

Atom One Light (light, from gitkraft).

pub fn night_owl() -> Self

Night Owl (dark, from gitkraft).

pub fn poimandres() -> Self

Poimandres (dark, from gitkraft).

pub fn flexoki_dark() -> Self

Flexoki Dark (dark, from gitkraft).

pub fn flexoki_light() -> Self

Flexoki Light (light, from gitkraft).

pub fn carbonfox() -> Self

Carbonfox (dark, from gitkraft).

pub fn andromeda() -> Self

Andromeda (dark, from gitkraft).

pub fn synthwave() -> Self

Synthwave (dark, from gitkraft).

pub fn ayu_dark() -> Self

Ayu Dark.

pub fn github_dark() -> Self

Github Dark.

pub fn github_light() -> Self

Github Light.

pub fn zenburn() -> Self

Zenburn.

pub fn super_mario() -> Self

Super Mario.

pub fn tokyo_night_moon() -> Self

Tokyo Night Moon.

pub fn tokyo_night_day() -> Self

Tokyo Night Day.

pub fn gruvbox_material() -> Self

Gruvbox Material.

pub fn nightfox() -> Self

Nightfox.

pub fn dawnfox() -> Self

Dawnfox.

pub fn melange() -> Self

Melange.

pub fn material_palenight() -> Self

Material Palenight.

pub fn tomorrow_night() -> Self

Tomorrow Night.

pub fn snazzy() -> Self

Snazzy.

pub fn iceberg() -> Self

Iceberg.

pub fn papercolor_light() -> Self

Papercolor Light.

pub fn synthwave_outrun() -> Self

Synthwave Outrun.

pub fn cobalt() -> Self

Cobalt.

pub fn modus_vivendi() -> Self

Modus Vivendi.

pub fn modus_operandi() -> Self

Modus Operandi.

pub fn horizon() -> Self

Horizon.

pub fn sonokai() -> Self

Sonokai.

pub fn clair_obscur() -> Self

Clair Obscur.

pub fn clair_obscur_canvas() -> Self

Clair Obscur Canvas.

pub fn mario_overworld() -> Self

Mario Overworld.

pub fn mario_underground() -> Self

Mario Underground.

pub fn pip_boy() -> Self

Pip Boy.

pub fn tarnished() -> Self

Tarnished.

pub fn hyrule() -> Self

Hyrule.

pub fn doom() -> Self

Doom.

pub fn phantom() -> Self

Phantom.

pub fn cavern_hush() -> Self

Cavern Hush.

pub fn test_chamber() -> Self

Test Chamber.

pub fn ember() -> Self

Ember.

pub fn meadow() -> Self

Meadow.

pub fn dojo() -> Self

Dojo.

pub fn underworld() -> Self

Underworld.

pub fn summit() -> Self

Summit.

pub fn rain_noir() -> Self

Rain Noir.

pub fn blocky() -> Self

Blocky.

pub fn everforest_light() -> Self

Everforest Light.

pub fn ayu_light() -> Self

Ayu Light.

pub fn duskfox() -> Self

Duskfox.

impl Theme

pub fn porsche() -> Self

Porsche: black/white with the signature red accent (#D5001C).

Bull is white and bear is red, as in the Porsche chart look.

pub fn colorblind() -> Self

Colorblind-safe theme (Okabe–Ito palette; blue/orange instead of green/red). Keeps the terminal background.

pub fn high_contrast() -> Self

Maximum-contrast theme: pure black/white with saturated status colors.

pub fn mono() -> Self

Monochrome theme for 1-bit-ish terminals: only white, gray and dark gray, terminal background. Selection is shown in reverse video colors.

pub fn all() -> Vec<Theme>

All built-in themes, in cycling order.

pub fn names() -> Vec<&'static str>

Names of all built-in themes, in cycling order.

pub fn by_name(name: &str) -> Option<Theme>

Look a built-in theme up by name. Case-insensitive; _ and spaces are accepted for - ("Tokyo Night" → tokyo-night).

pub fn next(&self) -> Theme

The next built-in theme (wraps). Custom-named themes start at default.

pub fn prev(&self) -> Theme

The previous built-in theme (wraps). Custom-named themes start at the last one.

impl Theme

pub fn style(&self) -> Style

Base style: foreground (+ background when set).

pub fn base_style(&self) -> Style

Alias of Theme::style (the name tui-chart used).

pub fn surface_style(&self) -> Style

Style for panels / cards: foreground on surface (falls back to the background).

pub fn muted_style(&self) -> Style

De-emphasised text style.

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

Border style; the focused variant uses border_focused and bold.

pub fn title_style(&self) -> Style

Title style (bold).

pub fn selected_style(&self) -> Style

Style of the selected item: selection_fg on selection_bg.

pub fn disabled_style(&self) -> Style

Style of disabled elements.

pub fn highlight_style(&self) -> Style

Style of search matches / markers: highlight color, bold.

pub fn status_color(&self, status: Status) -> Color

Color for a Status.

pub fn status_style(&self, status: Status) -> Style

Style for a Status (its color as foreground).

pub fn axis_style(&self) -> Style

Axis line style.

pub fn label_style(&self) -> Style

Tick / legend label style (same color as muted).

pub fn grid_style(&self) -> Style

Grid line style.

pub fn tooltip_style(&self) -> Style

Tooltip style: tooltip_fg on tooltip_bg.

pub fn fill(&self, area: Rect, buf: &mut Buffer)

Fill area with the theme background (no-op when there is none).

impl Theme

pub fn downgrade(&self, support: ColorSupport) -> Theme

Reduce every color of the theme to what support can display.

TrueColor is a no-op, Ansi256 maps RGB to Color::Indexed, Ansi16 maps everything to the 16 named colors and None resets all colors (and clears background/surface) so the terminal default is used.

pub fn downgrade_for_terminal(&self) -> Theme

Theme::downgrade using ColorSupport::detect.

impl Theme

pub fn from_base( name: &str, background: Option<Color>, foreground: Color, accent: Color, bull: Color, bear: Color, ) -> Self

Build a theme from the handful of colors an application already has.

Everything else is derived: RGB (and named/indexed) colors are blended between background (black when None) and foreground, so muted text, grid, borders, disabled text, surface and selection stay in tune. Success/bull use bull, error/bear use bear, primary/accent use accent; the palette starts with accent, bull, bear. Use the builder setters afterwards to fine-tune.

use ratatui::style::Color;
use tui_nuances::Theme;

let t = Theme::from_base(
    "app",
    Some(Color::Rgb(16, 16, 24)),
    Color::Rgb(230, 230, 240),
    Color::Rgb(213, 0, 28),
    Color::Green,
    Color::Red,
);
assert_eq!(t.primary, Color::Rgb(213, 0, 28));
assert!(t.palette.len() >= 8);

pub fn from_palette(name: &str, colors: &[Color]) -> Self

Build a theme from just a series palette (terminal background, white text). The first three colors become accent / bull / bear; the palette is cycled up to at least 8 entries. An empty slice yields the default palette.

use ratatui::style::Color;
use tui_nuances::Theme;

let t = Theme::from_palette("pair", &[Color::Red, Color::Blue]);
assert_eq!(t.palette.len(), 8);
assert_eq!(t.color(2), Color::Red);

pub fn colors(&self) -> Vec<Color>

Every color of the theme (background and surface included when set, palette last). Handy for audits and tests.

pub fn name(self, name: impl Into<String>) -> Self

Set the display name.

pub fn palette(self, palette: Vec<Color>) -> Self

Set the series palette (an empty palette is ignored).

pub fn background(self, background: Option<Color>) -> Self

Set (or clear) the background fill.

pub fn surface(self, surface: Option<Color>) -> Self

Set (or clear) the panel / card background.

pub fn foreground(self, color: Color) -> Self

Set the foreground color.

pub fn muted(self, color: Color) -> Self

Set the muted color.

pub fn disabled(self, color: Color) -> Self

Set the disabled color.

pub fn border(self, color: Color) -> Self

Set the border color.

pub fn border_focused(self, color: Color) -> Self

Set the border_focused color.

pub fn title(self, color: Color) -> Self

Set the title color.

pub fn primary(self, color: Color) -> Self

Set the primary color.

pub fn secondary(self, color: Color) -> Self

Set the secondary color.

pub fn accent(self, color: Color) -> Self

Set the accent color.

pub fn success(self, color: Color) -> Self

Set the success color.

pub fn warning(self, color: Color) -> Self

Set the warning color.

pub fn error(self, color: Color) -> Self

Set the error color.

pub fn info(self, color: Color) -> Self

Set the info color.

pub fn selection_bg(self, color: Color) -> Self

Set the selection_bg color.

pub fn selection_fg(self, color: Color) -> Self

Set the selection_fg color.

pub fn highlight(self, color: Color) -> Self

Set the highlight color.

pub fn bull(self, color: Color) -> Self

Set the bull color.

pub fn bear(self, color: Color) -> Self

Set the bear color.

pub fn neutral(self, color: Color) -> Self

Set the neutral color.

pub fn axis(self, color: Color) -> Self

Set the axis color.

pub fn grid(self, color: Color) -> Self

Set the grid color.

pub fn crosshair(self, color: Color) -> Self

Set the crosshair color.

pub fn tooltip_fg(self, color: Color) -> Self

Set the tooltip_fg color.

pub fn tooltip_bg(self, color: Color) -> Self

Set the tooltip_bg color.

pub fn tooltip(self, fg: Color, bg: Color) -> Self

Set the tooltip foreground/background colors.

pub fn selection(self, fg: Color, bg: Color) -> Self

Set the selection foreground/background colors.

pub fn color(&self, i: usize) -> Color

Palette color for series i (cycles; falls back to accent if empty).

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Self

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

Terminal-native theme built from named ANSI colors only.

impl From<&Theme> for Theme

fn from(t: &Theme) -> Self

Converts to this type from the input type.

impl PartialEq for Theme

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Theme

impl ThemeProvider for Theme

fn nuance_theme(&self) -> Theme

Produce the shared Theme for this application theme.