BLXAde

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.

On this page