Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/paulmcauley/klassy/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Kite global theme is the flagship theme of Klassy, designed to be pragmatic for long-term everyday use. It applies several components together:
  • Window Decoration
  • Application Style
  • Color Scheme
  • Plasma Style
  • Icons
Kite is the result of evolving the original Breeze theme to be more polished and usable, with influences from the original Breeze design, the “Blue Ocean” refresh, and the original KDE 1. A kite floats in the breeze!

Applying the Theme

To apply the Kite global theme:
  1. Go to System SettingsColors & ThemesGlobal Theme
  2. Select one of the Kite variants
  3. Click Apply
You must initially use the Global Theme settings screen to apply the theme properly. If you initially apply via the Quick Settings screen or the Light/Dark selector, the full desktop and window layout will not be applied. Afterwards, you can switch between Light/Dark for day/night.

Theme Variants

Kite comes in four main variants:
Kite Dark - Left PanelRecommended for 16:9 laptops, this variant places the panel on the left side of the screen with a dark color scheme.Left panel dark/light theme selectionBest for:
  • Widescreen laptops (16:9 aspect ratio)
  • Maximizing vertical space
  • Users who prefer dark themes

Design Philosophy

The Kite theme follows these core principles:

Pragmatic Design

Kite is designed for long-term everyday use, not for instant social media appeal. Every design decision prioritizes usability and polish.

Visual Refinement

  • Integrated Rounded Rectangles: Default buttons feature translucent outlined accent colors with a large clickable area
  • Accent Colors: Complements the Plasma “Blue Ocean” design refresh and system accent color feature
  • Consistent Iconography: Icons match across window decorations, context menus, and GTK applications

Customization Without Compromise

While Kite provides sensible defaults, it’s fully customizable through Klassy Settings. You can adjust:
  • Button shapes, sizes, and colors
  • Titlebar opacity and spacing
  • Window corner radius
  • Animation speeds
  • And much more

Switching Between Light and Dark

After initially applying the Kite global theme, you can easily switch between light and dark modes:
  1. Click the Quick Settings icon in the system tray
  2. Use the Light/Dark selector
  3. Or configure automatic switching based on time of day in System SettingsColors & Themes
The light/dark switcher will work correctly only after you’ve applied the full global theme at least once through System Settings.

Components Applied

When you apply a Kite global theme, the following components are configured:
ComponentWhat It Does
Window DecorationSets titlebar appearance, button styles, and window borders
Application StyleEnsures consistent styling in dockable panels, MDI applications, and tabs
Color SchemeApplies the base light or dark color palette
Plasma StyleStyles Plasma desktop elements like panels and widgets
Icon ThemeProvides consistent iconography across the desktop

Next Steps

Explore Presets

Try bundled presets for quick style changes

Customize Buttons

Fine-tune button appearance and behavior

Window Decorations

Adjust titlebar and window styling

Animations

Configure animation speeds and effects

Build docs developers (and LLMs) love