Files

s0wlz (Matthias Puchstein) e8d276161a feat: add Hyprland theme support

- Created Jinja2 template for Hyprland color configuration.
- Mapped system DNA to Hyprland variables (borders, accents, text).
- Updated documentation (README, INSTALL) to include Hyprland.

2025-12-31 00:48:50 +01:00

2.0 KiB

Raw Blame History

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)

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)

2.0 KiB Raw Blame History