donbox-themes

The twenty-three themes for Donbox, a Hyprland desktop for Fedora. A theme is a directory of small declarative files: a palette, a font set, a motion scheme, a wallpaper set and a preview. Nothing here is code, and nothing here belongs to one machine.

The core ships no themes. packages.toml in the Donbox checkout pins this repository by commit, donbox install fetches it to ~/.local/share/donbox/themes, and donbox theme update moves the pin deliberately. A theme can be added, corrected or replaced without touching the desktop that renders it.

Trying one

donbox theme pick            the carousel, wallpapers and all
donbox theme set ember       switch by slug
donbox theme accent orange   wear another of its accents

ember is the default; donbox theme schedule swaps between a theme and its pair with the sun.

A theme's shape

ember/
  colours.toml      the palette (the one required file)
  theme.toml        name, pair, contrast, base, accents
  fonts.toml        ui and mono families, size, weight
  motion.toml       durations, easings, reduce-motion
  backgrounds/      wallpapers, filename order is display
    SOURCES.json    where each picture came from
  preview.png       the switcher thumbnail

colours.toml carries mode (dark or light) and twenty-five colour keys, each "#rrggbb" in lower case:

accent selection muted
background dark_background darker_background
lighter_background
foreground dark_foreground light_foreground
bright_foreground
red yellow orange green cyan blue magenta brown
bright_red bright_yellow bright_green bright_cyan
bright_blue bright_magenta

Every key must be present: the renderer substitutes literally, and a missing key leaves {{ }} in a file some tool will then refuse. theme.toml relates a theme to its siblings: pair is the counterpart the schedule swaps to, contrast the higher-contrast variant, base what a variant derives from. One file, one concern; a font size never appears in colours.toml.

Making a theme

donbox theme new <slug> --from picture.png
donbox theme check <slug>

theme new derives a palette from a picture or a colour and lays the directory down; theme check gates it on the schema and a WCAG 4.5:1 contrast floor before the switcher will offer it. Wallpapers are numbered so the theme's own default comes first, and SOURCES.json records each picture's origin.

Licence

MIT for everything this repository authors; see LICENCE. The wallpapers under each theme's backgrounds/ keep the terms of their upstream sources, which SOURCES.json records picture by picture.