commit 36ab4e62f1913780b2dc6a6b91f37435be53be55
Author: s0wlz (Matthias Puchstein) <matthias@puchstein.lu>
Date:   Mon Dec 29 22:47:21 2025 +0100

    first commit;

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..82b9765
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# 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.
+
+## 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).
+
+## Project Structure
+
+- `src/`: Source YAML definitions containing the "DNA" of the themes.
+- `templates/`: Jinja2 templates for generating configuration files for various tools (Alacritty, Neovim, Zed, etc.).
+- `dist/`: Compiled theme files ready for deployment.
+- `apex-neon.md` / `apex-aeon.md`: Detailed specifications for each theme.
+
+## Authors
+
+- **S0wlz (Owlibou)**