chore: initial commit

hosts/example/default.nix

@@ -0,0 +1,24 @@
+# Example host — the template's "bin". Real, buildable, assembled from the
+# public modules; filled with placeholders where your inventory would go.
+# To adopt: replace hardware-configuration.nix (see its header), set hostName +
+# the user account below, then `nixos-rebuild switch --flake .#example`.
+
+{ pkgs, ... }:
+
+{
+  imports = [ ./hardware-configuration.nix ];
+
+  networking.hostName = "example";
+
+  # First NixOS version installed on this machine. Do not bump casually — see
+  # `man configuration.nix` (system.stateVersion).
+  system.stateVersion = "26.05";
+
+  # The login account. Rename to taste; the home-manager side is wired in
+  # flake.nix (home-manager.users.user) and hosts/example/home.nix.
+  users.users.user = {
+    isNormalUser = true;
+    extraGroups = [ "wheel" "networkmanager" "video" "input" ];
+    shell = pkgs.zsh;
+  };
+}

hosts/example/hardware-configuration.nix

@@ -0,0 +1,37 @@
+# ┌───────────────────────────────────────────────────────────────────────┐
+# │  PLACEHOLDER — REPLACE THIS FILE.                                       │
+# │                                                                         │
+# │  Generate the real one for YOUR machine:                                │
+# │      sudo nixos-generate-config --show-hardware-config \                │
+# │          > hosts/example/hardware-configuration.nix                     │
+# │                                                                         │
+# │  The values below are dummies. They let the flake EVALUATE and BUILD    │
+# │  (UUIDs are just strings until activation), so `nix flake check` stays  │
+# │  green — but this config will NOT boot on real hardware until replaced. │
+# └───────────────────────────────────────────────────────────────────────┘
+
+{ lib, modulesPath, ... }:
+
+{
+  imports = [ (modulesPath + "/installer/scan/not-detected.nix") ];
+
+  boot.initrd.availableKernelModules = [ "ahci" "xhci_pci" "sd_mod" ];
+  boot.initrd.kernelModules = [ ];
+  boot.kernelModules = [ ];
+  boot.extraModulePackages = [ ];
+
+  fileSystems."/" = {
+    device = "/dev/disk/by-uuid/00000000-0000-0000-0000-000000000000";
+    fsType = "ext4";
+  };
+
+  fileSystems."/boot" = {
+    device = "/dev/disk/by-uuid/0000-0000";
+    fsType = "vfat";
+    options = [ "fmask=0022" "dmask=0022" ];
+  };
+
+  swapDevices = [ ];
+
+  nixpkgs.hostPlatform = lib.mkDefault "x86_64-linux";
+}

hosts/example/home.nix

@@ -0,0 +1,17 @@
+# Example home identity — the per-user placeholders that a real inventory fills
+# in. Imported alongside the generic homeModules.default (see flake.nix).
+
+{ ... }:
+
+{
+  home.username = "user";
+  home.homeDirectory = "/home/user";
+  home.stateVersion = "26.05";
+
+  # Git identity. Set to your own; leaks into commit authorship anyway, so it
+  # belongs with the person, not the shared module.
+  programs.git.settings.user = {
+    name = "Example User";
+    email = "user@example.com";
+  };
+}