# 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)