From 80a25c16b9fcedbf7de8202180b5b64bb2abb252 Mon Sep 17 00:00:00 2001
From: Aron Gustafson <x1ugp1x@gmail.com>
Date: Sun, 25 Jan 2026 11:41:26 -0500
Subject: [PATCH] Update README.md

---
 README.md | 110 ++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 102 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 7b4f72d..0ee7244 100644
--- a/README.md
+++ b/README.md
@@ -25,17 +25,111 @@ All addon profiles, exports, and notes live inside their **respective addon fold
 ### DPS / Tank - Raid Layout
 ![WoW UI DPS-Tank-Raid Preview](https://git.makesandcrafts.com/aron/WoW-UI/raw/branch/main/Preview-Images/WoWScrnShot_012526_113112.jpg)
 
-
-<!--
-If you add more images later, just duplicate the block below:
-
-![WoW UI Preview](https://git.makesandcrafts.com/aron/WoW-UI/raw/branch/main/Preview-Images/IMAGE_NAME.jpg)
--->
-
 ---
 
 ## 📂 Repository Structure
 
 Each addon has its **own folder**, containing:
 - Profile export(s)
-- Configuration notes
\ No newline at end of file
+- Configuration notes
+
+---
+
+## ⌨️ Keybind Layout Method
+
+This UI follows a **consistent, role-agnostic keybind philosophy** designed for:
+- Minimal hand movement
+- High uptime
+- Easy muscle-memory transfer between characters
+
+### Keyboard Binds (Core)
+
+| Key | Purpose |
+|---|---|
+| `1–4` | Core rotation / builders / spenders |
+| `Q / E / R` | High-use cooldowns or rotational modifiers |
+| `F` | Lust-type ability (Bloodlust / Heroism / Drums) |
+| `Z / X / C / V` | Major cooldowns / utility |
+| `` ` `` | Extra Action Button (always bound) |
+
+These bindings are used across **DPS and Tank specs** wherever possible.
+
+---
+
+## 🖱️ MMO Mouse Button Mapping
+
+The MMO mouse is a **Corsair Scimitar Elite**, with buttons mapped in iCUE to **NumPad keys** for consistency across all characters.
+
+### Base Layer (No Modifier)
+
+| Mouse Button | iCUE Output | Assigned Role |
+|-------------|------------|---------------|
+| Mouse 1 | NumPad 1 |
+| Mouse 2 | NumPad 2 |
+| Mouse 3 | NumPad 3 |
+| Mouse 4 | NumPad 4 |
+| Mouse 5 | NumPad 5 |
+| Mouse 6 | NumPad 6 |
+| Mouse 7 | NumPad 7 |
+| Mouse 8 | NumPad 8 |
+| Mouse 9 | NumPad 9 |
+| Mouse 10 | NumPad / |
+| Mouse 11 | NumPad * |
+| Mouse 12 | NumPad - |
+
+---
+
+### MMO Mouse (Corsair Scimitar – Base Layer)
+
+Mouse buttons are mapped to **NumPad keys** in iCUE and used consistently in-game.
+
+| Mouse Button | Role |
+|---|---|
+| Mouse 1 | Interrupt |
+| Mouse 2 | Stun |
+| Mouse 3 | Crowd Control |
+| Mouse 4 | Mobility |
+| Mouse 5 | Defensive |
+| Mouse 6 | External / Self-heal |
+| Mouse 7 | Trinket / Offensive Utility |
+| Mouse 8 | Taunt (all tanks – fixed position) |
+| Mouse 9–12 | Spec-specific abilities |
+
+---
+
+### Modifier Philosophy
+
+- **Alt is the only modifier used**
+- No Shift / Ctrl bindings
+- Alt layer is reserved for:
+  - Utility
+  - Dispel / Purge
+  - Buffs
+  - Non-rotational actions
+
+This keeps bindings predictable and avoids finger gymnastics.
+
+---
+
+## 🩺 Clique: Mouseover & Healing Workflow
+
+All **friendly-target spell casting** (especially healing) is handled via **Clique**.
+
+### Why Clique is used
+- No mouseover macros required
+- Clean separation between damage binds and healing binds
+- Faster reaction time in group content
+- Consistent behavior across all healer specs
+- Plan to switch to Cell once it is released and did not want to reconfigure this even know DandersFrames has binding built-in as well
+
+### General Rules
+- **Left / Right / Middle click** are primary healing spells
+- **Alt-modified clicks** are secondary or AoE heals
+- **Shift is avoided** to prevent conflicts
+
+### Notes
+- Clique is used for **all healer specializations**
+- Damage abilities remain on keyboard / mouse binds
+- Friendly dispels, externals, and emergency buttons are typically Clique-bound
+
+Addon-specific Clique bindings (if applicable) are documented inside that addon’s folder.
\ No newline at end of file