diff --git a/.config/hypr/.luarc.json b/.config/hypr/.luarc.json
new file mode 100644
index 0000000..babfd90
--- /dev/null
+++ b/.config/hypr/.luarc.json
@@ -0,0 +1,8 @@
+{
+  "workspace": {
+    "library": ["/usr/share/hypr/stubs"]
+  },
+  "diagnostics": {
+    "globals": ["hl"]
+  }
+}
diff --git a/.config/hypr/hyprland.lua b/.config/hypr/hyprland.lua
new file mode 100644
index 0000000..8b0f2a7
--- /dev/null
+++ b/.config/hypr/hyprland.lua
@@ -0,0 +1,15 @@
+-- ┌──────────────────────────────────────────────────────────────┐
+-- │              hyprland.lua — entry point (0.55+)             │
+-- └──────────────────────────────────────────────────────────────┘
+-- Each require() is a separate Lua scope: errors in one file won't
+-- kill the others. Keep this file lean — just source the modules.
+
+require("config.colors")       -- color variables (sourced first)
+require("config.variables")    -- general, decoration, animations…
+require("config.monitors")     -- monitor layout + workspace pinning
+monitors = require("config.monitors")
+require("config.input")        -- keyboard / mouse / device config
+require("config.keybinds")     -- all hl.bind() calls
+require("config.windowrules")  -- hl.window_rule() calls
+require("config.autostart")    -- exec-once equivalents
+require("config.workspaces")   -- workspace configuration