From adb939c45b6fcc1efc176513cf66ea8b33fab4b4 Mon Sep 17 00:00:00 2001
From: _cry64 <them@dobutterfliescry.net>
Date: Sat, 7 Mar 2026 18:18:10 +1000
Subject: [PATCH] rename home-manager.nix -> home.nix

add options.users.users.<name>.manageHome
---
 cerulean/nixos/default.nix      |  2 +-
 cerulean/nixos/home-manager.nix | 49 -----------------------
 cerulean/nixos/home.nix         | 69 +++++++++++++++++++++++++++++++++
 3 files changed, 70 insertions(+), 50 deletions(-)
 delete mode 100644 cerulean/nixos/home-manager.nix
 create mode 100644 cerulean/nixos/home.nix

diff --git a/cerulean/nixos/default.nix b/cerulean/nixos/default.nix
index 8d96f08..e2c780d 100644
--- a/cerulean/nixos/default.nix
+++ b/cerulean/nixos/default.nix
@@ -33,7 +33,7 @@
     ]
     ++ (
       if _cerulean.homeManager != null
-      then [./home-manager.nix]
+      then [./home.nix]
       else []
     );
 
diff --git a/cerulean/nixos/home-manager.nix b/cerulean/nixos/home-manager.nix
deleted file mode 100644
index 8c1aa8b..0000000
--- a/cerulean/nixos/home-manager.nix
+++ /dev/null
@@ -1,49 +0,0 @@
-# Copyright 2025-2026 _cry64 (Emile Clark-Boman)
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-{
-  root,
-  config,
-  lib,
-  _cerulean,
-  ...
-} @ args: let
-  inherit
-    (builtins)
-    attrNames
-    filter
-    pathExists
-    ;
-in {
-  imports = [
-    _cerulean.homeManager.nixosModules.default
-  ];
-
-  home-manager = {
-    users =
-      config.users.users
-      |> attrNames
-      |> filter (x: pathExists (root + "/homes/${x}"))
-      |> (x:
-        lib.genAttrs x (y:
-          import (root + "/homes/${y}")));
-
-    extraSpecialArgs = _cerulean.specialArgs;
-    sharedModules = [
-      # user configuration
-      (import (root + "/nixpkgs.nix"))
-      # options declarations
-      (import ./nixpkgs.nix (args // {contextName = "homes";}))
-    ];
-  };
-}
diff --git a/cerulean/nixos/home.nix b/cerulean/nixos/home.nix
new file mode 100644
index 0000000..a63b6e8
--- /dev/null
+++ b/cerulean/nixos/home.nix
@@ -0,0 +1,69 @@
+# Copyright 2025-2026 _cry64 (Emile Clark-Boman)
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+{
+  root,
+  config,
+  lib,
+  _cerulean,
+  ...
+} @ args: let
+  inherit
+    (builtins)
+    attrNames
+    filter
+    pathExists
+    ;
+in {
+  imports = [
+    _cerulean.homeManager.nixosModules.default
+  ];
+
+  options = {
+    users.users = lib.mkOption {
+      type = lib.types.attrsOf (lib.types.submodule {
+        options.manageHome = lib.mkOption {
+          type = lib.types.bool;
+          default = true;
+          example = false;
+          description = ''
+            Whether Cerulean should automatically enable home-manager for this user,
+            and manage their home configuration declaratively.
+
+            Enabled by default, but can be disabled if necessary.
+          '';
+        };
+      });
+    };
+  };
+
+  config = {
+    home-manager = {
+      users =
+        config.users.users
+        |> attrNames
+        |> filter (x: pathExists (root + "/homes/${x}"))
+        |> (x:
+          lib.genAttrs x (y:
+            import (root + "/homes/${y}")));
+
+      extraSpecialArgs = _cerulean.specialArgs;
+      sharedModules = [
+        # user configuration
+        (import (root + "/nixpkgs.nix"))
+        # options declarations
+        (import ./nixpkgs.nix (args // {contextName = "homes";}))
+      ];
+    };
+  };
+}