s0wlz (Matthias Puchstein)
8d6fe00ad8
- Set up project structure and Source of Truth (GEMINI.md). - Implement DNA source files (src/*.yaml) with semantic color definitions. - Build clinical light (Aeon) and high-contrast dark (Neon) specifications. - Create Jinja2-based build system (build.py) using uv for reproducibility. - Implement Neovim theme template mirroring the philosophy.
80 lines
3.6 KiB
Markdown
80 lines
3.6 KiB
Markdown
# Apex Theme System: GEMINI Context
|
|
|
|
This file serves as the persistent brain and Source of Truth for the Apex Theme System (Neon & Aeon). It defines the philosophy, DNA, and rules that must be adhered to in all generated code and configurations.
|
|
|
|
## 1. Project Philosophy
|
|
**"State over Decoration."**
|
|
Apex is not about pretty colors; it is about signal clarity.
|
|
- **Neon** is a high-contrast dark theme for low-light focus.
|
|
- **Aeon** is a clinical, high-clarity light theme for daylight precision.
|
|
- Both share a unified semantic discipline: color exists only to communicate state.
|
|
|
|
## 2. The Color DNA (Source of Truth)
|
|
|
|
### Core & Semantics
|
|
|
|
| Role | Apex Neon (Dark) | Apex Aeon (Light) | Note |
|
|
|---|---|---|---|
|
|
| **Background** | `#050505` (Void Black) | `#f5f5f5` (Void White) | The Canvas |
|
|
| **Foreground** | `#ededed` (Stark White) | `#0a0a0a` (Near Black) | Primary Text |
|
|
| **Primary/Error**| `#ff0044` (Razor Red) | `#ff0044` (Razor Red) | Aggressor/Focus |
|
|
| **Info/Accent** | `#00eaff` (Electric Cyan)| `#007a88` (Deep Cyan) | Technical/Info |
|
|
| **Success** | `#00ff99` | `#00b377` | OK/Pass |
|
|
| **Warning** | `#ffb700` | `#d18f00` | Alert/Load |
|
|
| **Special** | `#9d00ff` | `#7a3cff` | Root/Admin |
|
|
| **Azure** | `#0088cc` | `#005577` | Structural/Functions |
|
|
|
|
### UI Surfaces
|
|
|
|
| Role | Apex Neon (Dark) | Apex Aeon (Light) |
|
|
|---|---|---|
|
|
| **Main BG** | `#050505` | `#f5f5f5` |
|
|
| **Panel/Soft** | `#141414` | `#e8e8e8` |
|
|
| **Border/Muted**| `#262626` | `#737373` |
|
|
| **High Surface**| N/A | `#ffffff` |
|
|
| **Muted Text** | `#737373` | `#737373` |
|
|
| **Stealth** | `#404040` | `#a0a0a0` |
|
|
|
|
### ANSI Tables (16-Color)
|
|
|
|
| Slot | Role | Neon Hex | Aeon Hex |
|
|
|---|---|---|---|
|
|
| 0 | Black/Bg | `#050505` | `#0a0a0a` |
|
|
| 1 | Red | `#ff0044` | `#ff0044` |
|
|
| 2 | Green | `#00ff99` | `#00b377` |
|
|
| 3 | Yellow | `#ffb700` | `#d18f00` |
|
|
| 4 | Blue | `#00eaff` | `#007a88` |
|
|
| 5 | Magenta | `#9d00ff` | `#7a3cff` |
|
|
| 6 | Cyan | `#00eaff` | `#007a88` |
|
|
| 7 | White/Fg | `#ededed` | `#f5f5f5` |
|
|
| 8 | BrBlack | `#262626` | `#737373` |
|
|
| 9 | BrRed | `#ff8899` | `#ff4d6d` |
|
|
| 10 | BrGreen | `#2bffb2` | `#33d6a6` |
|
|
| 11 | BrYellow | `#ffd24d` | `#ffbf40` |
|
|
| 12 | BrBlue | `#5af3ff` | `#33bccc` |
|
|
| 13 | BrMagenta| `#c84dff` | `#a680ff` |
|
|
| 14 | BrCyan | `#5af3ff` | `#33bccc` |
|
|
| 15 | BrWhite | `#ffffff` | `#ffffff` |
|
|
|
|
## 3. The Axioms (Immutable Rules)
|
|
|
|
1. **If it's not important, it does not glow.** Reserve high brightness/saturation for active states.
|
|
2. **Red is the Predator.** Red (`#ff0044`) is the color of **Active Intent**. It marks the Hunter (Cursor), the Territory (Current Directory), the Target (Selection), and the Threat (Critical Error). It signals "Live Fire." If it's Red, it is either you or a problem you need to kill.
|
|
3. **Text turns Black on Red.** When the background is `#ff0044`, the text must be `#050505` (Neon) or `#0a0a0a` (Aeon) for contrast. This is non-negotiable.
|
|
4. **Cyan is Informational.** Never use Cyan for errors or destruction.
|
|
5. **Purple is Sacred.** Reserved for special modes, root access, or exceptional states.
|
|
6. **Bright = Escalation.** Use bright ANSI variants (8-15) only when a state is elevated or active. Use **Bright Red** (`color9`) for errors to distinguish them from the cursor/path.
|
|
7. **No Random Accents.** If a color has no semantic reason to be there, remove it.
|
|
|
|
## 4. Repository Map
|
|
/
|
|
├── GEMINI.md # This file. Source of Truth.
|
|
├── src/ # Raw DNA
|
|
│ ├── neon.yaml # Apex Neon definitions
|
|
│ └── aeon.yaml # Apex Aeon definitions
|
|
├── templates/ # Jinja2 templates for build targets
|
|
│ ├── nvim/
|
|
│ ├── zed/
|
|
│ └── alacritty/
|
|
└── dist/ # Compiled theme files (gitignore this)
|