Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AhmedSaadi0/NibrasShell/llms.txt

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

NibrasShell ships with 8 preset themes, each with a dark and light variant. Every theme defines a full color palette, Hyprland border styles, typography choices, and system integration settings (GTK, Qt, Kvantum) — so switching a theme changes the entire look of your desktop in one step. You can also override individual colors per component through the Settings App without leaving your chosen base theme.

​
Preset themes

Dracula

A dark, vampiric palette built around deep purples (#bd93f9), electric cyan (#8be9fd), and neon green (#50fa7b). Pairs with the Dracula GTK theme and Plasma color scheme. Ships with a pre-generated depth overlay for the desktop clock.

Catppuccin

Soft pastel tones available in four Mocha-style flavors (dark and light variants). Primary color is Catppuccin Blue (#89B4FA), secondary is Pink (#F38BA8). Uses the Catppuccin Mocha GTK theme.

Material / Material You

Google-style dynamic theming powered by the KDE Plasma MaterialYouDark color scheme. Colors are pulled from Kirigami’s theme engine at runtime, so they update whenever you change your system accent. Enable _enableDynamicColoring to generate colors from your wallpaper instead.

Nord

Arctic blues and grey-blues inspired by the Nord color system. Cool, restrained, and easy on the eyes for long sessions.

Gruvbox

Warm retro colors with earthy yellows, oranges, and muted greens. Available in dark and light variants. A popular choice for terminal-heavy workflows.

Tokyo Night

A deep blue-purple cityscape palette that evokes a neon-lit skyline. Dark and high-contrast, with vibrant accent colors against near-black backgrounds.

Colors

A minimal single-color theme centered on electric cyan (#22C1EB) and vivid magenta (#FD02FF). Uses the Shades of Purple GTK theme. Good as a starting point for your own custom palette.

Deer

A unique nature-inspired theme built around soft lavender (#DCB5F3), warm peach (#F7B28A), and sky blue (#A2E8FF) against a dark forest background. Designed around the deer wallpaper with a pre-built depth overlay.

​
The color system

Each theme exposes a structured color palette through BaseTheme.qml. Colors are organized into semantic roles so that every UI component can reference the right token without hard-coding hex values.
primary is the main accent color used for highlights, active states, and interactive elements. onPrimary is the foreground color rendered on top of it (text, icons). secondary provides a complementary accent for secondary actions and indicators. onSecondary is its paired foreground.
tertiary is a third accent used for decorative elements, tags, and additional contrast. onTertiary is its foreground pair.
Semantic status colors for notifications, validation feedback, and OSD indicators:
  • error / onError — destructive actions and failure states
  • success / onSuccess — confirmation and positive feedback
  • warning / onWarning — caution and non-critical alerts
The top bar has three background/foreground pairs (topbarBgColorV1, topbarBgColorV2, topbarBgColorV3 and their Fg equivalents) plus a base topbarColor and topbarFgColor. This lets different sections of the bar use distinct shades while staying coordinated with the theme.
Volume and brightness on-screen displays use volOsdBgColor and volOsdFgColor, which can be set independently from the rest of the bar.
All colors respect the global _alpha property — lowering it applies uniform transparency across every color in the theme.

​
Switching themes

1

Open the Settings App

Press your configured shortcut to open the Settings App, or click the settings icon in the left sidebar.
2

Go to Appearance

Navigate to the Appearance section. You will see a grid of all available themes with live previews.
3

Select a theme

Click any theme card to load it immediately. NibrasShell applies the theme to the shell, Hyprland borders, GTK, Qt, Kvantum, and Konsole profiles in one operation.
4

Choose dark or light

Each preset has a Dark and Light variant. Toggle between them using the mode switch above the theme grid.
Theme selections persist across sessions. NibrasShell saves the active theme name to a session file and restores it on the next login.

​
Per-component color overrides

You can fine-tune colors for individual components without switching your base theme. In the Settings App, open the color editor for any of these components:
  • Top bar — background, foreground, and each of the three variant pairs
  • Left sidebar — all three background/foreground layer pairs
  • OSD — volume and brightness indicator colors
  • Desktop clock — foreground color and shadow color
Changes are saved to a per-theme cache file (for example, ~/.cache/nibrasshell/themes/DraculaDark.json). Resetting a component restores it to the theme’s original default.

​
Material You parameters

When using the Material You theme with dynamic coloring enabled, three parameters control how the generated palette looks:
ParameterKeyDefaultEffect
Scheme variantscheme_variant2Selects the M3 tone-mapping variant (tonal spot, vibrant, expressive, etc.)
Chroma multiplierdynamicColoringChromaMult2.5Scales color saturation — higher values produce more vivid output
Tone multiplierdynamicColoringToneMult1.0Shifts the overall lightness of the generated palette
You can adjust all three in the Settings App under the Material You theme options, or edit them directly in your theme cache file.
If the generated colors feel too muted, increase dynamicColoringChromaMult to 3.0 or 3.5. If they feel too bright, lower it toward 1.5.

Build docs developers (and LLMs) love

Get started for freeTalk to us