Struct ThemeManager 

pub struct ThemeManager { /* private fields */ }

Central theme management system for the application.

ThemeManager provides thread-safe access to theme data and supports runtime theme switching. It maintains the current theme state and provides accessor methods for all color values used throughout the application.

Thread Safety

The ThemeManager is designed to be used as a global singleton wrapped in a Mutex. All color accessor methods are thread-safe and include fallback mechanisms.

Implementations

impl ThemeManager

pub fn init_global(config: &ThemeConfig) -> AppResult<()>

Initializes the global theme manager singleton.

This method must be called once at application startup before any theme colors are accessed. It loads the initial theme from the provided configuration.

Arguments

• config - Theme configuration specifying the initial theme and flavor

Returns

Ok(()) if initialization succeeds

Errors

Returns an error if:

• The theme manager is already initialized
• The initial theme cannot be loaded
• Theme files are invalid or missing

Examples

use quetty::theme::{manager::ThemeManager, types::ThemeConfig};

let config = ThemeConfig {
    theme_name: "catppuccin".to_string(),
    flavor_name: "mocha".to_string(),
};
ThemeManager::init_global(&config)?;

pub fn global() -> &'static Mutex<ThemeManager>

Gets a reference to the global theme manager instance.

Returns

A reference to the Mutex-wrapped ThemeManager

Panics

Panics if the theme manager has not been initialized with [init_global]

Examples

use quetty::theme::manager::ThemeManager;

let manager = ThemeManager::global();
let mut theme_manager = manager.lock().unwrap();
theme_manager.switch_theme("nightfox", "carbonfox")?;

impl ThemeManager

pub fn text_primary() -> Color

impl ThemeManager

pub fn text_muted() -> Color

impl ThemeManager

pub fn surface() -> Color

impl ThemeManager

pub fn primary_accent() -> Color

impl ThemeManager

pub fn title_accent() -> Color

impl ThemeManager

pub fn header_accent() -> Color

impl ThemeManager

pub fn selection_bg() -> Color

impl ThemeManager

pub fn selection_fg() -> Color

impl ThemeManager

pub fn message_sequence() -> Color

impl ThemeManager

pub fn message_id() -> Color

impl ThemeManager

pub fn message_timestamp() -> Color

impl ThemeManager

pub fn message_delivery_count() -> Color

impl ThemeManager

pub fn message_state_ready() -> Color

impl ThemeManager

pub fn message_state_deferred() -> Color

impl ThemeManager

pub fn message_state_outcome() -> Color

impl ThemeManager

pub fn message_state_failed() -> Color

impl ThemeManager

pub fn namespace_list_item() -> Color

impl ThemeManager

pub fn status_success() -> Color

impl ThemeManager

pub fn status_warning() -> Color

impl ThemeManager

pub fn status_error() -> Color

impl ThemeManager

pub fn status_info() -> Color

impl ThemeManager

pub fn status_loading() -> Color

impl ThemeManager

pub fn shortcut_key() -> Color

impl ThemeManager

pub fn shortcut_description() -> Color

impl ThemeManager

pub fn help_section_title() -> Color

impl ThemeManager

pub fn popup_text() -> Color

impl ThemeManager

pub fn switch_theme( &mut self, theme_name: &str, flavor_name: &str, ) -> AppResult<()>

Switches to a new theme by name and flavor.

This method loads and activates a new theme at runtime. All subsequent color accessor calls will use the new theme colors.

Arguments

• theme_name - Name of the theme (e.g., “catppuccin”, “nightfox”)
• flavor_name - Name of the flavor (e.g., “mocha”, “carbonfox”)

Returns

Ok(()) if the theme switch succeeds

Errors

Returns an error if:

• The theme or flavor does not exist
• Theme files are invalid or corrupted
• File system access fails

Examples

use quetty::theme::manager::ThemeManager;

let mut manager = ThemeManager::global().lock().unwrap();
manager.switch_theme("catppuccin", "latte")?;

pub fn switch_theme_from_config( &mut self, config: &ThemeConfig, ) -> AppResult<()>

Switches to a new theme using a ThemeConfig struct.

Convenience method for switching themes when you have a ThemeConfig.

Arguments

• config - Theme configuration containing theme and flavor names

Returns

Ok(()) if the theme switch succeeds

Errors

Returns the same errors as [switch_theme]

pub fn discover_themes_with_metadata( &self, ) -> AppResult<ThemeCollectionWithMetadata>

Discovers all available themes with their metadata and icons.

This method scans the theme directories and loads metadata for all available themes and flavors. It includes display names, icons, and other theme information.

Returns

ThemeCollectionWithMetadata containing all discovered themes with their metadata

Errors

Returns an error if theme discovery or loading fails

Examples

use quetty::theme::manager::ThemeManager;

let manager = ThemeManager::global().lock().unwrap();
let themes = manager.discover_themes_with_metadata()?;

for (theme_name, flavors) in themes {
    println!("Theme: {}", theme_name);
    for (flavor_name, theme_icon, flavor_icon) in flavors {
        println!("  {} {} {}", theme_icon, flavor_icon, flavor_name);
    }
}

pub fn global_discover_themes_with_metadata() -> AppResult<ThemeCollectionWithMetadata>

Static method to discover themes using the global theme manager.

Convenience method that accesses the global theme manager and discovers available themes. This method is thread-safe and includes lock contention handling.

Returns

ThemeCollectionWithMetadata containing all discovered themes

Errors

Returns an error if:

• Theme manager is not initialized
• Lock cannot be acquired
• Theme discovery fails

Examples

use quetty::theme::manager::ThemeManager;

let themes = ThemeManager::global_discover_themes_with_metadata()?;