first

templates/home-manager-module/default.nix

@@ -0,0 +1,144 @@
+# Home Manager Module Template
+# This is a template for creating new Home Manager modules in m3ta-nixpkgs
+# Copy this template and modify it for your specific module
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+with lib; let
+  cfg = config.programs.myProgram; # Replace 'myProgram' with your program/module name
+  # Common locations: config.programs.*, config.services.*, config.m3ta.*
+in {
+  # Define options that users can set in their Home Manager configuration
+  options.programs.myProgram = {
+    enable = mkEnableOption "my custom program"; # Replace with your program description
+
+    # Example: Package option
+    package = mkOption {
+      type = types.package;
+      default = pkgs.hello; # Replace with your package
+      defaultText = literalExpression "pkgs.hello";
+      description = "The package to use";
+    };
+
+    # Example: String option
+    configDir = mkOption {
+      type = types.str;
+      default = "${config.xdg.configHome}/myprogram";
+      defaultText = literalExpression ''"''${config.xdg.configHome}/myprogram"'';
+      description = "Directory to store configuration";
+    };
+
+    # Example: Boolean option
+    enableBashIntegration = mkOption {
+      type = types.bool;
+      default = true;
+      description = "Whether to enable Bash integration";
+    };
+
+    # Example: Attribute set for settings
+    settings = mkOption {
+      type = types.attrs;
+      default = {};
+      example = literalExpression ''
+        {
+          theme = "dark";
+          fontSize = 12;
+        }
+      '';
+      description = "Configuration settings written to config file";
+    };
+
+    # Example: Lines of text (for config files)
+    extraConfig = mkOption {
+      type = types.lines;
+      default = "";
+      example = ''
+        # Custom configuration
+        option = value
+      '';
+      description = "Extra configuration to append to the config file";
+    };
+
+    # Example: Environment variables
+    environmentVariables = mkOption {
+      type = types.attrsOf types.str;
+      default = {};
+      example = {MY_VAR = "value";};
+      description = "Environment variables to set";
+    };
+  };
+
+  # Define what happens when the module is enabled
+  config = mkIf cfg.enable {
+    # Add package to user profile
+    home.packages = [cfg.package];
+
+    # Set environment variables
+    home.sessionVariables = cfg.environmentVariables;
+
+    # Create configuration file
+    # Method 1: Using xdg.configFile
+    xdg.configFile."myprogram/config.conf" = {
+      text = ''
+        # Generated by Home Manager
+        ${builtins.toJSON cfg.settings}
+        ${cfg.extraConfig}
+      '';
+    };
+
+    # Method 2: Using home.file for non-XDG locations
+    # home.file.".myprogramrc".text = ''
+    #   # Configuration here
+    # '';
+
+    # Example: Bash integration
+    programs.bash.initExtra = mkIf cfg.enableBashIntegration ''
+      # My program bash integration
+      eval "$(${cfg.package}/bin/myprogram init bash)"
+    '';
+
+    # Example: Zsh integration
+    programs.zsh.initExtra = mkIf cfg.enableBashIntegration ''
+      # My program zsh integration
+      eval "$(${cfg.package}/bin/myprogram init zsh)"
+    '';
+
+    # Example: Fish integration
+    # programs.fish.interactiveShellInit = mkIf cfg.enableFishIntegration ''
+    #   ${cfg.package}/bin/myprogram init fish | source
+    # '';
+
+    # Example: Systemd user service
+    systemd.user.services.myprogram = {
+      Unit = {
+        Description = "My Program Service";
+        After = ["graphical-session.target"];
+      };
+
+      Service = {
+        Type = "simple";
+        ExecStart = "${cfg.package}/bin/myprogram daemon";
+        Restart = "on-failure";
+        RestartSec = 5;
+      };
+
+      Install = {
+        WantedBy = ["default.target"];
+      };
+    };
+
+    # Example: Create directories
+    # home.file."${cfg.configDir}/.keep".text = "";
+
+    # Example: Manage symlinks
+    # home.file."bin/myprogram".source = "${cfg.package}/bin/myprogram";
+  };
+
+  # Module metadata (optional)
+  meta = {
+    maintainers = with lib.maintainers; []; # Add your name if in nixpkgs
+  };
+}