Conditional Patterns

Prefer lib Functions Over if-then-else

mkIf - Conditional Config Blocks

config = lib.mkIf cfg.enable {
  programs.git.enable = true;
  home.packages = [ pkgs.git ];
};

# Nested conditional
programs.vim = lib.mkIf cfg.enableVim {
  enable = true;
};

optionals - Conditional List Items

home.packages = [
  pkgs.coreutils
] ++ lib.optionals cfg.enableTools [
  pkgs.ripgrep
  pkgs.fd
] ++ lib.optionals pkgs.stdenv.isLinux [
  pkgs.linuxTool
];

optionalString - Conditional Strings

programs.bash.initExtra = '''
  # Always included
  export EDITOR=vim
''' + lib.optionalString cfg.enableAliases '''
  alias ll='ls -la'
''';

mkMerge - Combine Conditional Blocks

config = lib.mkMerge [
  # Always applied
  {
    programs.bash.enable = true;
  }

  # Conditionally applied
  (lib.mkIf cfg.enableGit {
    programs.git.enable = true;
  })

  (lib.mkIf cfg.enableVim {
    programs.vim.enable = true;
  })
];

When if-then-else is OK

Only use when lib functions make it too complicated:

# OK - simple value selection
theme = if isDark then "dark" else "light";

# Prefer mkIf for config blocks