3.8 KiB
3.8 KiB
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 | #737373 |
#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)
- If it's not important, it does not glow. Reserve high brightness/saturation for active states.
- 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. - 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. - Cyan is Informational. Never use Cyan for errors or destruction.
- Purple is Sacred. Reserved for special modes, root access, or exceptional states.
- 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. - 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/ │ ├── zsh/ │ ├── kitty/ │ ├── gemini/ │ ├── gtk4/ │ ├── hyprland/ │ ├── fuzzel/ │ ├── waybar/ │ ├── zathura/ │ ├── btop/ │ ├── swaync/ │ └── alacritty/ └── dist/ # Compiled theme files (gitignore this)