Theme Types

Overview

Six concrete theme implementations are available, each extending BeepTheme and overriding approximately 200 token properties. Themes provide cohesive visual language: button colors, fonts, border radii, surface colors, chart palettes, and more. Each theme is composed of multiple partial class files, totaling over 120 files across all themes. The BeepThemesManager singleton manages registration, lookup, and active theme switching.

Theme Structure

public abstract class BeepTheme : IBeepTheme
{
    public string ThemeName { get; set; }
    public Color BackgroundColor { get; set; }
    public Color ForegroundColor { get; set; }
    // ... ~200 overridable token properties
}
// Each concrete theme overrides the tokens it changes from default

UbuntuTheme

Inspired by Ubuntu Linux's Yaru theme. Uses a warm palette with orange accents, dark sidebar, and light content surfaces. Two variants: Light (white surfaces, dark sidebar) and Dark (charcoal surfaces, dark sidebar). Composed of 26 partial files covering all control types.

The 26 partial files for UbuntuTheme mirror the BeepTheme structure: Core, Button, TextBox, ComboBox, CheckBox, RadioButton, Grid, Chart, Calendar, Tab, Stepper, Tree, Menu, Navigation, Wizard, Card, Dialog, Login, Dashboard, StatusBar, ToolTip, Gradient, ColorPalette, FontAndTypography, ScrollBar, ProgressBar.

GNOMETheme

Follows GNOME's Adwaita design language. Flat surfaces, 8px rounded corners, gray and blue as primary tones. Clean, modern, and consistent with GNOME desktop applications. Supports light and dark variants through the same partial file override structure.

CyberpunkTheme

Neon-drenched dark theme inspired by cyberpunk aesthetics. Magenta (#FF00FF) primary accent with cyan (#00FFFF) secondary. Near-black backgrounds (#0D0D0D, #1A1A1A), glow effects on hover states, and high-contrast neon text. Dark-only; no light variant.

public partial class CyberpunkTheme : BeepTheme
{
    public CyberpunkTheme()
    {
        ThemeName = "Cyberpunk";
        BackgroundColor = Color.FromArgb(13, 13, 13);
        ForegroundColor = Color.FromArgb(0, 255, 255); // cyan

        // Buttons
        ButtonBackColor = Color.FromArgb(255, 0, 255);       // magenta
        ButtonForeColor = Color.Black;
        ButtonBorderColor = Color.FromArgb(255, 0, 255);
        ButtonHoverColor = Color.FromArgb(255, 51, 255);     // lighter magenta
        ButtonPressedColor = Color.FromArgb(200, 0, 200);

        // Glow
        EnableGlowEffects = true;
        GlowColor = Color.FromArgb(255, 0, 255);
        GlowBlurRadius = 10;

        // Font
        DefaultFont = new Font("Consolas", 9f, FontStyle.Regular);
        TitleFont = new Font("Consolas", 14f, FontStyle.Bold);

        // Border
        BorderRadius = 4;
    }
}

CandyTheme

Soft pastel palette with large rounded corners (12px+) and playful bubble shapes. Single-file theme targeting light backgrounds. Pinks, lavenders, mint greens, and sky blues dominate. Rounded buttons, pill-shaped badges, and generous padding create a friendly, approachable UI.

public class CandyTheme : BeepTheme
{
    public CandyTheme()
    {
        ThemeName = "Candy";
        BackgroundColor = Color.FromArgb(255, 245, 249);
        ForegroundColor = Color.FromArgb(74, 44, 58);
        BorderRadius = 14;
        Opacity = 1.0f;

        ButtonBackColor = Color.FromArgb(255, 107, 157);
        ButtonForeColor = Color.White;
        ButtonBorderColor = Color.Transparent;
        ButtonHoverColor = Color.FromArgb(255, 133, 179);

        DefaultFont = new Font("Segoe UI", 9.5f);
        TitleFont = new Font("Segoe UI", 12f, FontStyle.Bold);
    }
}

ZenTheme

Earth-tone palette inspired by Japanese zen aesthetics and nature. Sage greens, warm beiges, terracotta accents, and soft browns. Serif-like typography feel with Georgia or similar fonts. Minimal chrome — borders are subtle, drop shadows are light, and the overall feel is calm and deliberate.

public class ZenTheme : BeepTheme
{
    public ZenTheme()
    {
        ThemeName = "Zen";
        BackgroundColor = Color.FromArgb(245, 240, 232);
        ForegroundColor = Color.FromArgb(74, 59, 47);
        BorderRadius = 4;
        Opacity = 0.98f;

        ButtonBackColor = Color.FromArgb(124, 154, 110);
        ButtonForeColor = Color.White;
        ButtonBorderColor = Color.FromArgb(107, 138, 94);
        ButtonHoverColor = Color.FromArgb(141, 176, 125);

        DefaultFont = new Font("Georgia", 10f);
        TitleFont = new Font("Georgia", 13f, FontStyle.Bold);
    }
}

CyberpunkNeonTheme

A brighter, more saturated variant of CyberpunkTheme. Hot magenta (#FF1493), electric cyan (#00E5FF), and neon green (#39FF14) accents. 5 partial files for the core overrides (Core, Button, Menu, Grid, Gradient). Designed for applications that want the cyberpunk aesthetic but with higher luminance and more aggressive color contrast.

BeepThemesManager

The BeepThemesManager is a singleton that manages all theme registration, lookup, and active theme switching. Controls query it for the current active theme during painting. When the theme changes, all controls subscribing to the ThemeChanged event invalidate and repaint themselves.

public sealed class BeepThemesManager
{
    private static readonly Lazy<BeepThemesManager> _instance =
        new Lazy<BeepThemesManager>(() => new BeepThemesManager());

    public static BeepThemesManager Instance => _instance.Value;

    public IBeepTheme CurrentTheme { get; private set; }
    public string CurrentThemeName => CurrentTheme?.ThemeName ?? "Default";

    public event EventHandler ThemeChanged;

    private readonly Dictionary<string, IBeepTheme> _themes = new(StringComparer.OrdinalIgnoreCase);

    public void RegisterTheme(IBeepTheme theme)
    {
        if (theme == null) throw new ArgumentNullException(nameof(theme));
        _themes[theme.ThemeName] = theme;
    }

    public bool SetTheme(string themeName)
    {
        if (!_themes.TryGetValue(themeName, out var theme))
            return false;

        var previous = CurrentTheme;
        CurrentTheme = theme;

        if (previous != CurrentTheme)
            ThemeChanged?.Invoke(this, EventArgs.Empty);

        return true;
    }

    public IBeepTheme GetTheme(string themeName)
    {
        return _themes.TryGetValue(themeName, out var theme) ? theme : null;
    }

    public IEnumerable<string> GetThemeNames() => _themes.Keys;

    public void InitializeDefaultThemes()
    {
        RegisterTheme(new UbuntuTheme());
        RegisterTheme(new GNOMETheme());
        RegisterTheme(new CyberpunkTheme());
        RegisterTheme(new CandyTheme());
        RegisterTheme(new ZenTheme());
        RegisterTheme(new CyberpunkNeonTheme());
        SetTheme("Ubuntu"); // default
    }
}

Examples

// Global theme switching
BeepThemesManager.Instance.InitializeDefaultThemes(); // register all 6 themes
BeepThemesManager.Instance.SetTheme("Cyberpunk");

// Check current theme
string currentTheme = BeepThemesManager.Instance.CurrentThemeName;
Console.WriteLine($"Active theme: {currentTheme}"); // "Cyberpunk"

// Register a custom theme
var customTheme = new BeepTheme
{
    ThemeName = "CorporateBlue",
    ButtonBackColor = Color.FromArgb(0, 82, 204),
    ButtonForeColor = Color.White,
    ButtonBorderColor = Color.FromArgb(0, 70, 180),
    ButtonHoverColor = Color.FromArgb(0, 100, 230),
    BackgroundColor = Color.FromArgb(244, 245, 247),
    ForegroundColor = Color.FromArgb(23, 43, 77),
    BorderRadius = 4,
    DefaultFont = new Font("Segoe UI", 9f),
    TitleFont = new Font("Segoe UI", 12f, FontStyle.SemiBold),
    // ... override all needed tokens
};
BeepThemesManager.Instance.RegisterTheme(customTheme);
BeepThemesManager.Instance.SetTheme("CorporateBlue");

// Subscribe to theme changes
BeepThemesManager.Instance.ThemeChanged += (s, e) =>
{
    Console.WriteLine($"Theme switched to: {BeepThemesManager.Instance.CurrentThemeName}");
    // Re-apply any custom overrides that got wiped
};

// Theme selection UI
var themeNames = BeepThemesManager.Instance.GetThemeNames().ToList(); // [Ubuntu, GNOME, Cyberpunk, Candy, Zen, CyberpunkNeon]
comboBoxTheme.Items.AddRange(themeNames);
comboBoxTheme.SelectedValueChanged += (s, e) =>
{
    BeepThemesManager.Instance.SetTheme(comboBoxTheme.SelectedItem.ToString());
};

// Per-control theme inspection
var theme = BeepThemesManager.Instance.CurrentTheme;
Console.WriteLine($"Button color: {theme.ButtonBackColor}");
Console.WriteLine($"Grid header: {theme.GridHeaderBackColor}");
Console.WriteLine($"Chart palette[0]: {theme.ChartPalette[0]}");