Appearance & themes
Theme families, wallpapers, fonts, glass surfaces, terminal dim, and custom packages.
Appearance is configured under Settings → Appearance. Choices apply to Login, Main Menu, Settings, canvas chrome, and (where marked) glass surfaces.
Theme family + scheme
Each built-in family has Light and Dark token variants. Separately choose:
- Automatic / System scheme
- Light or Dark
- Adaptive family behavior tracks the last family used for the effective scheme
Examples of built-in families: Jade River, Synthwave City, Roastwood, Neon Circuit, Rose Bloom, Linen Note, Black Nova, Evergreen, Solstice, Orchid Code, Pixel Meadow.
IDs are stable; display names are localized.
Wallpapers
- Library merges built-ins + installed packages (scheme-compatible)
- Per-family / per-scheme selection
- Video wallpapers can animate (
auto/ enabled / disabled); badges mark animated options - Pixelation 0–24 (theme default or override); family switch resets to the target theme’s default
- Login / Main Menu / Canvas share the effective wallpaper treatment
Fonts and size
- UI font: follow theme or global override (Inter, Chakra Petch, Poppins, Architects Daughter, Geist Mono, Pixelify Sans, …)
- Size: small / medium / large (~90% / 100% / 110%)
- Terminals keep the theme monospace face
Glass surfaces
- Transparency and blur (theme default or custom per family)
- Radius scale 0–200% of the theme’s radius contract
- Applies to cards, dialogs, login/main panels, canvas node shells, and select popovers — not toolbars, docks, or embedded iframe/media
Terminal dim (Light mode)
Optional: terminals use a dimmed dark palette while the rest of the UI stays light. Live xterm repaints; CLI theme env updates on next spawn.
Custom theme packages
Advanced users can drop packages under:
~/.blxade/themes/<id>/
theme.manifest
theme.css(App-config themes/ is also scanned.) Packages must pass strict validation
(complete Light/Dark tokens, contrast, media rules). The Global Agent
theme_maker can scaffold a package but does not activate it automatically —
pick it in Appearance after refresh.
Bundled IDs are reserved; userhome wins over app-config for the same id.
Pre-paint
Theme, scheme, font, surface, and radius preferences cache so the first frame matches without a flash. SQLite remains source of truth after load.
Related: Settings, Plans & Makers
(theme_maker), Terminals.