Theming & Ecosystem • v0.13.0

Theme Customization & Repository Ecosystem

Axonwall features an extensible, token-driven theming architecture supporting over 20 curated Web Console palettes—including canonical Solarized, Gruvbox, Catppuccin, and pure OLED black—plus a branded axonwall Plymouth graphical boot splash and hardware-level ZFSBootMenu UEFI splash and ANSI boot-console theming via axonwall-zbm-theme. Learn how to create custom palettes, publish multi-theme Git repositories, import community themes with 1-click, and brand your appliance boot environment.

Token-Based Theme Engine

The Axonwall theme engine dynamically computes and injects standard CSS custom properties into document.documentElement and the body element. This allows instantaneous theme switching with zero page reload and zero layout shift.

Zero-Flash Hydration

An early inline hydration script reads the user's stored preference from localStorage before paint, eliminating white-flash transients.

Winnegans Cross-Compatibility

Dual-emits both Axonwall tokens (--theme-*) and Winnegans reading tokens (--wf-*) for interoperability across web apps.

Dynamic Live Tuner

Users can tweak hex values in real time through the in-app Theme Switcher and save them as persistent custom palettes.

Core Theme Color Tokens

Token NameCSS Custom PropertyUI Role & Usage
colors.bg--theme-bg, --wf-bgPrimary page viewport background
colors.cardBg--theme-card, --wf-card-bgSurface layer, card container, sidebar, and modals
colors.border--theme-border, --wf-borderDividers, card outlines, table borders, and inputs
colors.text--theme-text, --wf-textPrimary headline and body typography
colors.textMuted--theme-text-mutedSecondary labels, metadata, and timestamps
colors.accent--theme-accent, --wf-accentAction buttons, primary links, active badges, and highlights
colors.ring--theme-ring, --wf-ringFocus indicators and neon ambient glow effects

Authoring a Custom Theme

A custom theme is a standalone JSON file adhering to the AxonwallTheme specification. You can create a file from scratch, modify an existing preset, or export directly from the in-app Theme Switcher.

Example: tactical-nord.json
json
{
  "$schema": "https://axonwall.com/schemas/theme.json",
  "id": "tactical-nord",
  "name": "Tactical Nord",
  "description": "Arctic polar night palette with aurora teal and frost blue accents",
  "category": "dark-ambient",
  "isDark": true,
  "author": "Axonwall Community",
  "version": "1.0.0",
  "colors": {
    "bg": "#2e3440",
    "text": "#eceff4",
    "textMuted": "#d8dee9",
    "cardBg": "#3b4252",
    "border": "#4c566a",
    "accent": "#88c0d0",
    "accentHover": "#81a1c1",
    "ring": "#88c0d0",
    "readerBg": "#2e3440",
    "readerText": "#eceff4",
    "readerCoord": "#81a1c1",
    "selectionBg": "#434c5e",
    "selectionText": "#eceff4"
  }
}
Testing Your Theme Locally
Open the in-app Theme Switcher in the top navigation bar, navigate to the Import Repo / File tab, and click Select .json Theme File. Your theme will be validated, applied instantly, and stored in your browser's local storage.

Building a Multi-Theme Repository

You can publish a collection of themes in a standard Git repository (such as GitHub, GitLab, or any public Git host). When users paste your repository URL into the Theme Switcher, Axonwall fetches your catalog index and imports all themes in one click.

Recommended Repository Structure
bash
my-theme-pack/
├── themes.json             # Root catalog manifest (Required for 1-click import)
├── README.md               # Theme descriptions, screenshots, and instructions
├── previews/               # Optional PNG/SVG palette swatch previews
│   ├── tactical-nord.png
│   └── tokyo-night.png
└── themes/                 # Optional individual theme files
    ├── tactical-nord.json
    └── tokyo-night.json
Catalog Manifest Specification (themes.json)
json
{
  "$schema": "https://axonwall.com/schemas/theme-manifest.json",
  "name": "Nordic Security Themes",
  "version": "1.0.0",
  "description": "High-visibility Arctic and nocturnal security themes for Axonwall",
  "homepage": "https://github.com/my-org/my-theme-pack",
  "author": "Security Ops Team",
  "themes": [
    {
      "id": "tactical-nord",
      "name": "Tactical Nord",
      "description": "Arctic polar night palette with frost teal accents",
      "category": "dark-ambient",
      "isDark": true,
      "colors": {
        "bg": "#2e3440",
        "text": "#eceff4",
        "textMuted": "#d8dee9",
        "cardBg": "#3b4252",
        "border": "#4c566a",
        "accent": "#88c0d0",
        "accentHover": "#81a1c1",
        "ring": "#88c0d0",
        "selectionBg": "#434c5e",
        "selectionText": "#eceff4"
      }
    },
    {
      "id": "aurora-green",
      "name": "Aurora Borealis",
      "description": "Deep spruce black with radiant polar aurora emerald",
      "category": "cyber",
      "isDark": true,
      "colors": {
        "bg": "#0a1410",
        "text": "#e6fffa",
        "textMuted": "#68d391",
        "cardBg": "#122820",
        "border": "#1c3d31",
        "accent": "#38a169",
        "accentHover": "#48bb78",
        "ring": "#38a169",
        "selectionBg": "#1c4532",
        "selectionText": "#f0fff4"
      }
    }
  ]
}
Automatic GitHub Resolution
When a user pastes a GitHub repository URL (such as https://github.com/my-org/my-theme-pack), Axonwall automatically resolves the URL to raw GitHub content at main/themes.json (falling back to main/theme.json if a single theme is hosted).

Importing & Managing Themes

Both the Axonwall documentation website and the Web Console application embed the identical Theme Switcher. Users have three seamless ways to manage their palettes:

1. Local JSON Upload

Click Select .json Theme File in the Theme Switcher. Drop any theme or manifest file to import instantly into browser memory.

2. Remote Repo URL

Paste any GitHub repository or raw CDN URL into the remote field. The client validates the schema and loads the entire palette collection.

3. In-App Color Tuner

Adjust background, card, border, text, and accent colors in the Color Tuner tab, give your new palette a name, and save it as a custom theme.

WinnegansFake Cross-Ecosystem Compatibility

Axonwall shares its underlying theme specification with the Winnegans Research Project . Themes authored for Winnegans automatically work in Axonwall, and vice versa.

Access All 19 Winnegans Palettes
All 19 official Winnegans themes—including Ethan Schoonover's Solarized Dark and Light, Pavel Pertsev's Gruvbox, Catppuccin (Mocha, Macchiato, Frappé, Latte), Obsidian OLED, and Crimson Midnight—are built directly into Axonwall out-of-the-box.

ZFSBootMenu UEFI Splash & Boot-Screen Theming

Beyond the browser-based Web Console, Axonwall v0.13.0 ships axonwall-zbm-theme to customize the physical/KVM early-boot environment on ZFS installations. It renders a branded 24-bit UEFI .splash BMP image into the ZFSBootMenu v3.1.0 Unified Kernel Image (UKI), configures high-DPI Linux framebuffer console fonts (Terminus / Lat15), applies tactical 16-color ANSI kernel VT palettes, and automatically synchronizes the rebuilt EFI binary across mirrored EFI System Partitions (/boot/efi and /boot/efi-mirror).

cyber-cyan

Default Axonwall deep-navy & electric cyan tactical HUD

emerald-ops

Phosphor emerald NOC/SOC high-contrast terminal

amber-tactical

Warm amber CRT night-vision rack console palette

crimson-soc

Obsidian black & crimson red-team / Vault alert styling

mono-stealth

Minimalist monochrome grayscale for low-light colocation cages

bash
# List built-in ZFSBootMenu boot-screen palettes and active font/splash status
sudo axonwall-zbm-theme list

# Apply a tactical boot palette, embed UEFI .splash BMP, rebuild ZBM UKI, and sync mirrored ESPs
sudo axonwall-zbm-theme apply emerald-ops --font ter-v24b

# Inspect ZFSBootMenu boot environments & snapshot rollback integration
sudo axonwallctl zbm status
ZFSBootMenu Boot Environments & Rollback
For full details on ZFSBootMenu v3.1.0 boot environment cloning, pre-update ZFS snapshot rollback, and mirrored EFI System Partition redundancy, see the Hardware Installer, RAID & ZFS Boot Environments documentation.

Branded Plymouth Boot Splash (axonwall)

From early initramfs handoff right up to the local appliance console (axonwall-console), Debian-based Axonwall appliances, live ISOs, and cloud images display the custom axonwall Plymouth theme installed under /usr/share/plymouth/themes/axonwall.

Fortified Crest & 50 Hz Pulse

Renders the Axonwall neural shield mounted on a fortified obsidian brick wall with crossed battle axes in front and a 50 Hz emerald-cyan breathing glow behind the core emblem.

LUKS2 Passphrase & FSCK Progress

Replaces plain text prompts with a dark emerald-bordered passphrase input dialog, status telemetry (including firstboot provisioning), and interactive Esc live kernel/systemd log toggling.

Serial Console Coexistence

Boots with plymouth.ignore-serial-consoles and console=ttyS0,115200 console=tty0 so graphical VGA/EFI displays remain active even when an IPMI/SOL serial port is attached.

bash
# Verify installed Plymouth themes and active default theme
plymouth-set-default-theme --list
plymouth-set-default-theme

# Re-apply the branded Axonwall splash theme and regenerate initramfs across installed kernels
sudo plymouth-set-default-theme axonwall -R
Toggle Live Boot Logs Any Time
Press Esc during graphical startup to switch seamlessly between the branded Plymouth splash and verbose systemd/kernel boot logs—or select the explicit Serial Console entry in GRUB/ISOLINUX to boot with nosplash plymouth.enable=0.