diff --git a/dots/.vortex-core/README.md b/dots/.vortex-core/README.md
deleted file mode 100644
index 5bf4ef2..0000000
--- a/dots/.vortex-core/README.md
+++ /dev/null
@@ -1,19 +0,0 @@
-# Keyboard configuration
-
-Keyboard configuration for the Vortex Core 40% keyboard.
-
-Generated using [TsFreddie's MPC tool](https://tsdo.in/much-programming-core/).
-
-Note: this is assuming `Caps lock` is remapped to `Esc` on press and `Ctrl` on hold (e.g. using `caps2esc`).
-
-## Layer 0
-
-Macros are mainly used for shift, ctrl & alt modifiers.
-
-![](l0.png)
-
-## Layer 1
-
-Lighting configuration layer with some macros for workspaces.
-
-![](l1.png)
diff --git a/home/modules/keyboard/default.nix b/home/modules/keyboard/default.nix
new file mode 100644
index 0000000..9685e7b
--- /dev/null
+++ b/home/modules/keyboard/default.nix
@@ -0,0 +1,16 @@
+{
+  config,
+  lib,
+  ...
+}:
+
+{
+  options.keyboard.vortexCore.enable = lib.mkEnableOption "Vortex Core keyboard configuration files";
+
+  config = lib.mkIf config.keyboard.vortexCore.enable {
+    home.file.".vortex-core" = {
+      source = ./vortex-core;
+      recursive = true;
+    };
+  };
+}
diff --git a/home/modules/keyboard/vortex-core/README.md b/home/modules/keyboard/vortex-core/README.md
new file mode 100644
index 0000000..fbed64d
--- /dev/null
+++ b/home/modules/keyboard/vortex-core/README.md
@@ -0,0 +1,19 @@
+# keyboard
+
+keyboard configuration for a Vortex Core 40%, generated using [TsFreddie's MPC
+tool](https://tsdo.in/much-programming-core/).
+
+note: this is assuming `Caps lock` is remapped to `Esc` on press and `Ctrl` on
+hold (e.g. using `caps2esc`).
+
+## layer 0
+
+macros are mainly used for shift, ctrl & alt modifiers.
+
+![](l0.png)
+
+## layer 1
+
+lighting configuration layer with some macros for workspaces.
+
+![](l1.png)
diff --git a/dots/.vortex-core/l0.png b/home/modules/keyboard/vortex-core/l0.png
similarity index 100%
rename from dots/.vortex-core/l0.png
rename to home/modules/keyboard/vortex-core/l0.png
diff --git a/dots/.vortex-core/l1.png b/home/modules/keyboard/vortex-core/l1.png
similarity index 100%
rename from dots/.vortex-core/l1.png
rename to home/modules/keyboard/vortex-core/l1.png
diff --git a/dots/.vortex-core/layout.cys b/home/modules/keyboard/vortex-core/layout.cys
similarity index 100%
rename from dots/.vortex-core/layout.cys
rename to home/modules/keyboard/vortex-core/layout.cys
diff --git a/dots/.vortex-core/layout.txt b/home/modules/keyboard/vortex-core/layout.txt
similarity index 100%
rename from dots/.vortex-core/layout.txt
rename to home/modules/keyboard/vortex-core/layout.txt