erebos

Erebos namespace for Netsnek e.U. dark theme and theming engine. Generates accessible dark mode palettes, manages theme tokens, and provides runtime theme sw...

Enter the Dark Side

Erebos provides dark theming for web applications. It generates WCAG-compliant palettes, manages CSS variables and design tokens, and enables runtime theme switching without page reload.

Use Erebos when you need dark mode support, accessible color palettes, or a theming system for your web app.

How Erebos Works

Erebos builds theme tokens from a base palette. It computes contrast ratios and validates accessibility before output. The engine supports:

• Palette generation — Produce dark backgrounds with sufficient contrast
• Preview mode — Visualize themes in browser or terminal
• Export — Output CSS variables, JSON tokens, or design-system formats

Theme Commands

Run the theme generator:

# Generate palette from seed colors
./scripts/theme-gen.sh --palette "#1a1a2e" "#16213e"

# Preview in browser (opens local HTML)
./scripts/theme-gen.sh --preview

# Export tokens to stdout or file
./scripts/theme-gen.sh --export --format css

Arguments

Argument	Purpose
--palette	Base colors for palette generation
--preview	Launch preview mode (no file output)
--export	Export theme tokens (requires format choice)

Design Example

/* Erebos output */
:root[data-theme="erebos-dark"] {
  --bg-primary: #1a1a2e;
  --bg-secondary: #16213e;
  --text-primary: #eaeaea;
  --text-secondary: #a0a0a0;
  --accent: #0f3460;
}