Open Source|All improvements go through Pull Requests with automated CI checks before review by@Leo-Galli|Join Discord|Contributing guide
Token reference

Theming — Token reference

Full CSS token reference and custom theme creation.

Dark mode tokens

:root {
  --aetheris-bg: 9 9 11;
  --aetheris-surface: 20 20 24;
  --aetheris-raised: 26 26 31;
  --aetheris-border: 39 39 42;
  --aetheris-fg: 250 250 250;
  --aetheris-muted: 161 161 170;
  --aetheris-faint: 113 113 122;
  --aetheris-accent: 16 185 129;
  --aetheris-accent-strong: 5 150 105;
  --aetheris-accent-soft: rgba(16, 185, 129, 0.12);
}

Light mode overrides

[data-theme="light"] {
  --aetheris-bg: 250 250 250;
  --aetheris-surface: 255 255 255;
  --aetheris-fg: 9 9 11;
  --aetheris-border: 228 228 231;
}

Accent injection

Each accent defines three values:

TokenDescription
--aetheris-accentMain accent (buttons, links, highlights)
--aetheris-accent-strongDarker variant (gradients, hover)
--aetheris-accent-softTransparent background (badges, pills)

Custom themes

Create a CSS file in aetheris-themes/themes/:

[data-accent="mycolor"] {
  --aetheris-accent: 139 92 246;
  --aetheris-accent-strong: 124 58 237;
  --aetheris-accent-soft: rgba(139, 92, 246, 0.12);
}

Apply with data-accent="mycolor" on <html>.

Component classes

ClassDescription
.aetheris-cardGlass card with border and shadow
.aetheris-card-hoverCard with hover lift effect
.aetheris-btn-primaryGradient accent button
.aetheris-btn-secondaryGlass outline button
.aetheris-btn-ghostTransparent hover button
.aetheris-kickerSmall uppercase label
.aetheris-iconIcon container with glow
.aetheris-inputStyled form input
.aetheris-nav-linkSidebar navigation link
.aetheris-nav-link-activeActive nav link

See also: Theming overview, Whitelabeling.