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.
An early inline hydration script reads the user's stored preference from localStorage before paint, eliminating white-flash transients.
Dual-emits both Axonwall tokens (--theme-*) and Winnegans reading tokens (--wf-*) for interoperability across web apps.
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 Name | CSS Custom Property | UI Role & Usage |
|---|---|---|
| colors.bg | --theme-bg, --wf-bg | Primary page viewport background |
| colors.cardBg | --theme-card, --wf-card-bg | Surface layer, card container, sidebar, and modals |
| colors.border | --theme-border, --wf-border | Dividers, card outlines, table borders, and inputs |
| colors.text | --theme-text, --wf-text | Primary headline and body typography |
| colors.textMuted | --theme-text-muted | Secondary labels, metadata, and timestamps |
| colors.accent | --theme-accent, --wf-accent | Action buttons, primary links, active badges, and highlights |
| colors.ring | --theme-ring, --wf-ring | Focus 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.
{
"$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"
}
}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.
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{
"$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"
}
}
]
}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:
Click Select .json Theme File in the Theme Switcher. Drop any theme or manifest file to import instantly into browser memory.
Paste any GitHub repository or raw CDN URL into the remote field. The client validates the schema and loads the entire palette collection.
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.
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).
Default Axonwall deep-navy & electric cyan tactical HUD
Phosphor emerald NOC/SOC high-contrast terminal
Warm amber CRT night-vision rack console palette
Obsidian black & crimson red-team / Vault alert styling
Minimalist monochrome grayscale for low-light colocation cages
# 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
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.
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.
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.
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.
# 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
nosplash plymouth.enable=0.