Crate tui_nuances 

tui-nuances

Shared theming for ratatui widget libraries (tui-chart, tui-slider, tui-spinner, tui-rating, tui-piechart, tui-checkbox, tui-file-explorer, …): build one Theme and style every component of your app from it.

• Theme – ~30 named color slots (UI, status, selection, data-viz) with 90 built-ins: default, catppuccin-mocha, catppuccin-latte, dracula, nord, gruvbox, tokyo-night, solarized-dark, solarized-light, one-dark, rose-pine, monokai, default-light, grape, ocean, sunset, forest, rose, neon, gruvbox-light, catppuccin-frappe, catppuccin-macchiato, tokyo-night-storm, tokyo-night-light, kanagawa-wave, kanagawa-dragon, kanagawa-lotus, moonfly, nightfly, oxocarbon, cyberpunk, rose-pine-moon, rose-pine-dawn, ayu-mirage, everforest-dark, atom-one-light, night-owl, poimandres, flexoki-dark, flexoki-light, carbonfox, andromeda, synthwave, ayu-dark, github-dark, github-light, zenburn, super-mario, tokyo-night-moon, tokyo-night-day, gruvbox-material, nightfox, dawnfox, melange, material-palenight, tomorrow-night, snazzy, iceberg, papercolor-light, synthwave-outrun, cobalt, modus-vivendi, modus-operandi, horizon, sonokai, clair-obscur, clair-obscur-canvas, mario-overworld, mario-underground, pip-boy, tarnished, hyrule, doom, phantom, cavern-hush, test-chamber, ember, meadow, dojo, underworld, summit, rain-noir, blocky, everforest-light, ayu-light, duskfox, porsche, colorblind, high-contrast, mono.
• Theme::from_base / Theme::from_palette – derive a full theme from a few colors your app already has.
• Semantic styles – Theme::style, Theme::selected_style, Theme::border_style, Theme::status_style …
• color – mix / lighten / darken, WCAG contrast, color::readable_on, 256/16-color quantisation.
• ColorSupport + Theme::downgrade – adapt to the terminal (COLORTERM, TERM, NO_COLOR).
• Themed / ThemeProvider – glue for widget crates and app theme types.
• ThemeSwitcher – cycle themes in demos.

use ratatui::{style::Color, widgets::{Block, Borders, Paragraph}};
use tui_nuances::{Status, Theme};

let theme = Theme::by_name("tokyo-night").unwrap();
let block = Block::default()
    .borders(Borders::ALL)
    .border_style(theme.border_style(true))
    .title_style(theme.title_style())
    .style(theme.style());
let ok = Paragraph::new("all good").style(theme.status_style(Status::Success));
assert!(theme.palette.len() >= 8);

Features

• serde – Serialize/Deserialize for Theme (flat map of color strings).

Depending on it

tui-nuances = { git = "https://github.com/sorinirimies/tui-nuances" }

Modules

color

Color math on ratatui::style::Color: blending, luminance, WCAG contrast and terminal palette quantisation.

Structs

Theme

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

ThemeSwitcher

A wrapping cursor over a list of themes.

Enums

ColorSupport

How many colors the terminal can show.

Status

Status severity, each mapped to a theme color by Theme::status_color.

Constants

DEFAULT_PALETTE

Default series palette, used when a theme does not bring its own.

Traits

ThemeProvider

Implemented by application theme types to expose them as a Theme.

Themed

Implemented by widgets that can restyle themselves from a Theme.