cbfa26afb7
- Created Jinja2 template for SwayNC CSS. - Mapped system DNA to notification states (Critical, Normal, MPRIS). - Updated documentation and repository map.
2.1 KiB
2.1 KiB
Apex Theme System
"State over Decoration."
Apex is a semantic theme system designed for high-performance focus and clinical clarity. It moves away from purely aesthetic color choices, treating color as a functional tool to communicate system state, urgency, and user intent.
The system consists of two primary canvases:
- Apex Neon: A high-contrast dark theme for low-light focus.
- Apex Aeon: A clinical, high-clarity light theme for daylight precision.
Supported Platforms
The factory currently generates native themes for:
- Neovim (Lua)
- Zed (JSON extension)
- Alacritty (TOML)
- Kitty (Conf)
- Zsh (Theme with Radar/AAR)
- Gemini CLI (JSON)
- GTK4 / Libadwaita (CSS)
- Hyprland (Conf)
- Fuzzel (INI)
- Waybar (CSS variables)
- Zathura (Config)
- Btop (Theme)
- SwayNC (CSS)
The Apex DNA
Apex is built on a unified semantic discipline where every color has a specific role:
- Red is the Predator: Reserved for active intent, the cursor, current location, and critical errors. It signals "Live Fire."
- Cyan is Informational: Used for technical data, links, and neutral highlights.
- Purple is Sacred: Reserved for root access, special modes, or exceptional system states.
- Contrast is King: Non-negotiable rules for readability (e.g., Black text on Red backgrounds).
Development & Building
This project uses a custom build engine written in Python with Jinja2 templates.
Prerequisites
- uv (Recommended for dependency management)
- Python 3.12+
Build
To regenerate all theme files from the source DNA (src/*.yaml):
uv run build.py
Artifacts are output to the dist/ directory, organized by application.
Project Structure
src/: Source YAML definitions containing the "DNA" of the themes.templates/: Jinja2 templates for each supported application.dist/: Compiled theme files ready for deployment.GEMINI.md: AI Context & Source of Truth.apex-neon.md/apex-aeon.md: Detailed specifications.
Authors
- S0wlz (Owlibou)