9 files changed, 198 insertions, 18 deletions
diff --git a/config/hypr/UserConfigs/01-UserDefaults.conf b/config/hypr/UserConfigs/01-UserDefaults.conf
index dd5f299a..2dc537df 100644
--- a/config/hypr/UserConfigs/01-UserDefaults.conf
+++ b/config/hypr/UserConfigs/01-UserDefaults.conf
@@ -9,15 +9,18 @@
 
 # Set your default editor here uncomment and reboot to take effect.
 # NOTE, this will be automatically uncommented if you select neovim or vim to your default editor
-#env = EDITOR,vim #default editor
+env = EDITOR,nvim #default editor
 
 # Define preferred text editor for the KooL Quick Settings Menu (SUPER SHIFT E)
 # script will take the default EDITOR and nano as fallback
 $edit=${EDITOR:-nano}
+# Optional visual editor for Quick Settings (GUI or TTY command)
+$visual=${VISUAL:-}
 
 # These two are for UserKeybinds.conf & Waybar Modules
 $term = kitty # Terminal
 $files = thunar # File Manager
 
 # Default Search Engine for ROFI Search (SUPER S)
-$Search_Engine = "https://www.google.com/search?q={}"
-\ No newline at end of file
+$Search_Engine = "https://www.google.com/search?q={}"
+env = VISUAL,nvim #default visual editor for quick settings (optional)
diff --git a/config/hypr/UserConfigs/ENVariables.conf b/config/hypr/UserConfigs/ENVariables.conf
index e2b3498a..c9c229ed 100644
--- a/config/hypr/UserConfigs/ENVariables.conf
+++ b/config/hypr/UserConfigs/ENVariables.conf
@@ -54,3 +54,5 @@
 # env = AQ_MGPU_NO_EXPLICIT,1 # Disables explicit syncing on mgpu buffers
 # env = AQ_NO_MODIFIERS,1 # Disables modifiers for DRM buffers
 
+
+
diff --git a/config/hypr/UserConfigs/LayerRules.conf b/config/hypr/UserConfigs/LayerRules.conf
new file mode 100644
index 00000000..6ca3c180
--- /dev/null
+++ b/config/hypr/UserConfigs/LayerRules.conf
@@ -0,0 +1,14 @@
+# ==================================================
+#  KoolDots (2026)
+#  Project URL: https://github.com/LinuxBeginnings
+#  License: GNU GPLv3
+#  SPDX-License-Identifier: GPL-3.0-or-later
+# ==================================================
+# For layerrules
+# See https://wiki.hyprland.org/Configuring/Window-Rules/ for more
+
+# This file is used to add or overwrite layer rules
+# This file will not be modified during dotfiles updates
+
+# Example:
+# layerrule = blur on, ignore_alpha 0, match:namespace rofi
diff --git a/config/hypr/UserConfigs/UserDecorations.conf b/config/hypr/UserConfigs/UserDecorations.conf
index d962092f..e7e30651 100644
--- a/config/hypr/UserConfigs/UserDecorations.conf
+++ b/config/hypr/UserConfigs/UserDecorations.conf
@@ -14,9 +14,9 @@
 source = $HOME/.config/hypr/wallust/wallust-hyprland.conf
 
 general {
-  border_size = 2
-  gaps_in = 2
-  gaps_out = 4
+  border_size = 1
+  gaps_in = 4
+  gaps_out = 6
 
   col.active_border = $color12
   col.inactive_border = $color10
diff --git a/config/hypr/UserConfigs/UserKeybinds.conf b/config/hypr/UserConfigs/UserKeybinds.conf
index cc19ff78..38407eec 100644
--- a/config/hypr/UserConfigs/UserKeybinds.conf
+++ b/config/hypr/UserConfigs/UserKeybinds.conf
@@ -1,15 +1,11 @@
-# ==================================================
-#  KoolDots (2026)
-#  Project URL: https://github.com/LinuxBeginnings
-#  License: GNU GPLv3
-#  SPDX-License-Identifier: GPL-3.0-or-later
-# ==================================================
+# /* ---- 💫 https://github.com/JaKooLit 💫 ---- */  #
 # This is where you put your own keybinds. Be Mindful to check as well ~/.config/hypr/configs/Keybinds.conf to avoid conflict
 # if you think I should replace the Pre-defined Keybinds in ~/.config/hypr/configs/Keybinds.conf , submit an issue or let me know in DC and present me a valid reason as to why, such as conflicting with global shortcuts, etc etc
 
 # See https://wiki.hyprland.org/Configuring/Keywords/ for more settings and variables
 # See also Laptops.conf for laptops keybinds 
 
+# /* ---- ✴️ Variables ✴️ ---- */  #
 $mainMod = SUPER
 $scriptsDir = $HOME/.config/hypr/scripts
 $UserScripts = $HOME/.config/hypr/UserScripts
@@ -33,10 +29,14 @@ $UserConfigs = $HOME/.config/hypr/UserConfigs
 # E.g.
 # bindd = $mainMod, Z, My z app, exec APPNAME
 
+##############
+#  Rebinds   #
+##############
 
 
-
-
+##############
+#  unbinds   #
+##############
 
 
 
diff --git a/config/hypr/UserConfigs/WindowRules.conf b/config/hypr/UserConfigs/WindowRules.conf
index b6d65135..7ec0fd08 100644
--- a/config/hypr/UserConfigs/WindowRules.conf
+++ b/config/hypr/UserConfigs/WindowRules.conf
@@ -4,15 +4,12 @@
 #  License: GNU GPLv3
 #  SPDX-License-Identifier: GPL-3.0-or-later
 # ==================================================
-# For window rules and layerrules
+# For window rules
 # See https://wiki.hyprland.org/Configuring/Window-Rules/ for more
 
 # This file is used to add or overwrite window rules 
 # This file will not be modified during dotfiles updates
 
 
-#  Optional Layer rules
-#  To Resolve blurred corners in rofi  Uncomment
-# layerrule = blur on, ignore_alpha 0, match:namespace rofi
-
+# Layer rules now belong in UserConfigs/LayerRules.conf
 
diff --git a/config/hypr/UserConfigs/monitors.lua b/config/hypr/UserConfigs/monitors.lua
new file mode 100644
index 00000000..544380ed
--- /dev/null
+++ b/config/hypr/UserConfigs/monitors.lua
@@ -0,0 +1,18 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+
+-- User monitor overrides for Lua workflow.
+-- MonitorProfiles.sh writes selected Lua monitor profiles into this file.
+-- Keep custom hl.monitor(...) entries here so upgrades preserve them.
+
+-- Example:
+-- hl.monitor({
+--     output = "eDP-1",
+--     mode = "preferred",
+--     position = "auto",
+--     scale = "1",
+-- })
diff --git a/config/hypr/UserConfigs/user_decorations.lua b/config/hypr/UserConfigs/user_decorations.lua
new file mode 100644
index 00000000..6b34666e
--- /dev/null
+++ b/config/hypr/UserConfigs/user_decorations.lua
@@ -0,0 +1,106 @@
+-- ==================================================
+--  KoolDots (2026)
+--  Project URL: https://github.com/LinuxBeginnings
+--  License: GNU GPLv3
+--  SPDX-License-Identifier: GPL-3.0-or-later
+-- ==================================================
+
+-- User decorations overrides (auto-generated).
+-- This file is intentionally split from other user overrides.
+-- Add only user-specific Lua overrides here.
+-- Example:
+-- hl.config({ general = { gaps_in = 4, gaps_out = 8 } })
+
+-- Source reference from UserDecorations.conf (hyprlang):
+-- source = $HOME/.config/hypr/wallust/wallust-hyprland.conf
+-- general {
+-- border_size = 2
+-- gaps_in = 2
+-- gaps_out = 4
+-- col.active_border = $color12
+-- col.inactive_border = $color10
+-- }
+-- decoration {
+-- rounding = 10
+-- active_opacity = 1.0
+-- inactive_opacity = 0.9
+-- fullscreen_opacity = 1.0
+-- dim_inactive = true
+-- dim_strength = 0.1
+-- dim_special = 0.8
+-- shadow {
+-- enabled = true
+-- range = 3
+-- render_power = 1
+-- color =  $color12
+-- color_inactive = $color10
+-- }
+-- blur {
+-- enabled = true
+-- size = 6
+-- passes = 3
+-- new_optimizations = true
+-- xray = true
+-- ignore_opacity = true
+-- special = true
+-- popups = true
+-- }
+-- }
+-- group {
+-- col.border_active = $color15
+-- groupbar {
+-- col.active = $color0
+-- }
+-- }
+
+local function read_wallust_colors(path)
+  local colors = {}
+  local handle = io.open(path, "r")
+  if not handle then
+    return colors
+  end
+  for line in handle:lines() do
+    local key, hex = line:match("^%$([%w_]+)%s*=%s*rgb%(([0-9A-Fa-f]+)%)")
+    if key and hex then
+      colors[key] = "rgb(" .. hex .. ")"
+    end
+  end
+  handle:close()
+  return colors
+end
+
+local wallust_path = (os.getenv("HOME") or "") .. "/.config/hypr/wallust/wallust-hyprland.conf"
+local colors = read_wallust_colors(wallust_path)
+
+if next(colors) then
+  hl.config({
+    general = {
+      col = {
+        active_border = colors.color12 or "rgba(8db4ffff)",
+        inactive_border = colors.color10 or "rgba(5f6578ff)",
+      },
+    },
+  })
+
+  hl.config({
+    decoration = {
+      shadow = {
+        color = colors.color12 or "rgba(8db4ffff)",
+        color_inactive = colors.color10 or "rgba(5f6578ff)",
+      },
+    },
+  })
+
+  hl.config({
+    group = {
+      col = {
+        border_active = colors.color15 or "rgba(ffffffff)",
+      },
+      groupbar = {
+        col = {
+          active = colors.color0 or "rgba(0f111aff)",
+        },
+      },
+    },
+  })
+end
diff --git a/config/hypr/UserConfigs/user_keybinds.lua b/config/hypr/UserConfigs/user_keybinds.lua
new file mode 100644
index 00000000..91872105
--- /dev/null
+++ b/config/hypr/UserConfigs/user_keybinds.lua
@@ -0,0 +1,40 @@
+-- User keybind overrides (auto-generated).
+-- Add keybinds with bind("MODS", "KEY", fn, opts).
+-- Example:
+-- bind("SUPER", "Z", exec_cmd("ghostty"), { description = "Launch ghostty" })
+-- Helper functions live in ~/.config/hypr/lua/user_keybinds_helper.lua so they can be updated separately.
+local user_keybinds_helper = nil
+do
+  local source = (debug.getinfo(1, "S") or {}).source or ""
+  local source_path = source:match("^@(.+)$")
+  local source_dir = source_path and source_path:match("^(.*)/[^/]+$") or nil
+  local home = os.getenv("HOME") or ""
+  local candidate_paths = {
+    source_dir and (source_dir .. "/../lua/user_keybinds_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/lua/user_keybinds_helper.lua") or nil,
+    home ~= "" and (home .. "/.config/hypr/user_keybinds_helper.lua") or nil,
+  }
+
+  local tried_paths = {}
+  for _, helper_path in ipairs(candidate_paths) do
+    if helper_path then
+      table.insert(tried_paths, helper_path)
+      local f = io.open(helper_path, "r")
+      if f then
+        f:close()
+        local loaded_ok, loaded_helpers = pcall(dofile, helper_path)
+        if loaded_ok and type(loaded_helpers) == "table" and loaded_helpers.bind then
+          user_keybinds_helper = loaded_helpers
+          break
+        end
+      end
+    end
+  end
+
+  if not user_keybinds_helper then
+    error("Failed to load user_keybinds_helper.lua from: " .. table.concat(tried_paths, ", "))
+  end
+end
+local exec_cmd = user_keybinds_helper.exec_cmd
+local bind = user_keybinds_helper.bind
+