Use homeModules as flake output name for Home Manager modules

README.md

@@ -114,7 +114,7 @@ in
 {
   imports = [
     # For home-manager
-    nixvim.homeManagerModules.nixvim
+    nixvim.homeModules.nixvim
     # For NixOS
     nixvim.nixosModules.nixvim
     # For nix-darwin
@@ -158,7 +158,7 @@ flakes, just add the nixvim input:
 }
 ```
 
-You can now access the module using `inputs.nixvim.homeManagerModules.nixvim`,
+You can now access the module using `inputs.nixvim.homeModules.nixvim`,
 for a home-manager installation, `inputs.nixvim.nixosModules.nixvim`, for NixOS,
 and `inputs.nixvim.nixDarwinModules.nixvim` for nix-darwin.
 
@@ -167,7 +167,7 @@ and `inputs.nixvim.nixDarwinModules.nixvim` for nix-darwin.
 ## Usage
 NixVim can be used in four ways: through the home-manager, nix-darwin, NixOS modules,
 and standalone through the `makeNixvim` function. To use the modules, just import the
-`nixvim.homeManagerModules.nixvim`, `nixvim.nixDarwinModules.nixvim`, and
+`nixvim.homeModules.nixvim`, `nixvim.nixDarwinModules.nixvim`, and
 `nixvim.nixosModules.nixvim` modules, depending on which system
 you're using.
 

docs/user-guide/install.md

@@ -56,7 +56,7 @@ When used as a module, NixVim can be enabled though `programs.nixvim.enable`.
 
 When using NixVim as a module you must import the NixVim module into your module system.
 The three imports are:
-- `<nixvim>.homeManagerModules.nixvim`
+- `<nixvim>.homeModules.nixvim`
 - `<nixvim>.nixosModules.nixvim`
 - `<nixvim>.nixDarwinModules.nixvim`
 

flake/wrappers.nix

@@ -20,9 +20,17 @@
       nixvim = import ../wrappers/nixos.nix self;
       default = self.nixosModules.nixvim;
     };
-    homeManagerModules = {
+    # Alias for backward compatibility
+    # Added 2025-05-25 in https://github.com/nix-community/nixvim/pull/3387
+    homeManagerModules =
+      let
+        cond = lib.trivial.oldestSupportedReleaseIsAtLeast 2505;
+        msg = "nixvim: flake output `homeManagerModules` has been renamed to `homeModules`.";
+      in
+      lib.warnIf cond msg self.homeModules;
+    homeModules = {
       nixvim = import ../wrappers/hm.nix self;
-      default = self.homeManagerModules.nixvim;
+      default = self.homeModules.nixvim;
     };
     nixDarwinModules = {
       nixvim = import ../wrappers/darwin.nix self;

tests/nixpkgs-module.nix

@@ -71,7 +71,7 @@ let
         )
         {
           nixos = self.nixosModules.default;
-          hm = self.homeManagerModules.default;
+          hm = self.homeModules.default;
           nix-darwin = self.nixDarwinModules.default;
         }
     );

tests/platforms/hm-extra-files-byte-compiling.nix

@@ -39,7 +39,7 @@ let
       inherit pkgs;
 
       modules = [
-        self.homeManagerModules.nixvim
+        self.homeModules.nixvim
         config
         { programs.nixvim.performance.byteCompileLua.configs = true; }
       ];
@@ -50,7 +50,7 @@ let
       inherit pkgs;
 
       modules = [
-        self.homeManagerModules.nixvim
+        self.homeModules.nixvim
         config
         { programs.nixvim.performance.byteCompileLua.configs = false; }
       ];

tests/platforms/hm-submodule-merge.nix

@@ -50,7 +50,7 @@ let
           ];
         }
       )
-      self.homeManagerModules.nixvim
+      self.homeModules.nixvim
     ];
   };
 in

tests/platforms/hm.nix

@@ -18,6 +18,6 @@ self.inputs.home-manager.lib.homeManagerConfiguration {
 
       programs.home-manager.enable = true;
     }
-    self.homeManagerModules.nixvim
+    self.homeModules.nixvim
   ];
 }