2eea11c22f
- Updated README.md with full list of 7 supported platforms and build instructions. - Updated INSTALL.md to include GTK4 instructions and clarify Zed/GTK aggregated files. - Added 'Building' section to README.
59 lines
1.9 KiB
Markdown
59 lines
1.9 KiB
Markdown
# 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)
|
|
|
|
## 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](https://github.com/astral-sh/uv) (Recommended for dependency management)
|
|
- Python 3.12+
|
|
|
|
### Build
|
|
To regenerate all theme files from the source DNA (`src/*.yaml`):
|
|
|
|
```bash
|
|
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)** |