add empty template

.envrc

@@ -0,0 +1 @@
+template/.envrc

.github/workflows/ci.yml

@@ -8,7 +8,7 @@ concurrency:
   cancel-in-progress: true
 jobs:
   DeterminateCI:
-    uses: DeterminateSystems/ci/.github/workflows/workflow.yml@main
+    uses: dataheld/ci/.github/workflows/workflow.yml@pass-thru-failearly
     permissions:
       id-token: "write"
       contents: "read"

README.md

@@ -13,16 +13,28 @@ extra-[DRY](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself) 🤌
 ## Installing
 
 > \[!NOTE\]
+> This is not another flake or development framework.
+> It is much less; just the set of composable nix flakes and modules that I use for my projects.
+
+> \[!TIP\]
 > This is the software you need to have on your _system_.
 > All project-specific software is handled automatically.
 
 1. Install Nix (the package manager).
    The [Determinate Nix Installer](https://github.com/DeterminateSystems/nix-installer) is recommended.
+
 1. Install [direnv](https://direnv.net).
+
 1. (optional) Install
    [nix-direnv](https://github.com/nix-community/nix-direnv)
    for better performance during development.
-1. (if not already done) Clone the repo
+
+1. Add the necessary boilerplate files.
+
+   ```sh
+   nix flake init --template "https://flakehub.com/f/dataheld/nullkomma/0.1.*#default"
+   ```
+
 1. (one-time only) Inside the repo, run `direnv allow`
 
 > \[!TIP\]

flake.nix

@@ -7,69 +7,122 @@
     fh.url = "https://flakehub.com/f/DeterminateSystems/fh/0.1.*";
     flake-checker.url = "https://flakehub.com/f/DeterminateSystems/flake-checker/0.2.*";
     flake-iter.url = "https://flakehub.com/f/DeterminateSystems/flake-iter/0.1.*";
-    flake-parts.url = "https://flakehub.com/f/hercules-ci/flake-parts/0.1.*";
+    # keep-sorted end
+    flake-parts = {
+      inputs.nixpkgs-lib.follows = "nixpkgs";
+      url = "https://flakehub.com/f/hercules-ci/flake-parts/0.1.*";
+    };
     flake-schemas.url = "https://flakehub.com/f/DeterminateSystems/flake-schemas/0.1.*";
+    nix-unit = {
+      url = "github:nix-community/nix-unit/?tag=v2.24.1";
+      inputs = {
+        flake-parts.follows = "flake-parts";
+        nixpkgs.follows = "nixpkgs";
+      };
+    };
     treefmt-nix.url = "github:numtide/treefmt-nix/3d0579f5cc93436052d94b73925b48973a104204";
-    # keep-sorted end
   };
 
-  outputs = {flake-parts, ...} @ inputs:
-    flake-parts.lib.mkFlake {inherit inputs;} {
+  outputs =
+    { flake-parts, self, ... }@inputs:
+    flake-parts.lib.mkFlake { inherit inputs; } {
       imports = [
+        # keep-sorted start
+        inputs.nix-unit.modules.flake.default
         inputs.treefmt-nix.flakeModule
+        # keep-sorted end
       ];
       systems = [
-        "x86_64-linux"
-        "aarch64-linux"
+        # keep-sorted start
         "aarch64-darwin"
+        "aarch64-linux"
         "x86_64-darwin"
+        "x86_64-linux"
+        # keep-sorted end
       ];
-      perSystem = {
-        inputs',
-        pkgs,
-        self',
-        ...
-      }: {
-        devShells.default = pkgs.mkShell {
-          packages = [
-            # keep-sorted start
-            inputs'.fh.packages.default
-            inputs'.flake-checker.packages.default
-            inputs'.flake-iter.packages.default
-            pkgs.git
-            pkgs.gnumake
-            pkgs.nixd
-            self'.formatter
-            # keep-sorted end
-          ];
-        };
-        treefmt = {
-          programs = {
-            # keep-sorted start
-            actionlint.enable = true;
-            alejandra.enable = true;
-            beautysh.enable = true;
-            black.enable = true;
-            cmake-format.enable = true;
-            deadnix.enable = true;
-            hclfmt.enable = true;
-            isort.enable = true;
-            jsonfmt.enable = true;
-            keep-sorted.enable = true;
-            mdformat.enable = true;
-            prettier.enable = true;
-            shellcheck.enable = true;
-            shfmt.enable = true;
-            sqlfluff.enable = true;
-            toml-sort.enable = true;
-            yamlfmt.enable = true;
-            # keep-sorted end
+      perSystem =
+        {
+          inputs',
+          pkgs,
+          self',
+          ...
+        }:
+        {
+          devShells.default = pkgs.mkShell {
+            packages = [
+              # keep-sorted start
+              inputs'.fh.packages.default
+              inputs'.flake-checker.packages.default
+              inputs'.flake-iter.packages.default
+              pkgs.git
+              pkgs.gnumake
+              pkgs.nixd
+              self'.formatter
+              # keep-sorted end
+            ];
+          };
+          treefmt = {
+            programs = {
+              # keep-sorted start
+              actionlint.enable = true;
+              beautysh.enable = true;
+              black.enable = true;
+              cmake-format.enable = true;
+              deadnix.enable = true;
+              hclfmt.enable = true;
+              isort.enable = true;
+              jsonfmt.enable = true;
+              keep-sorted.enable = true;
+              mdformat.enable = true;
+              nixfmt.enable = true;
+              prettier.enable = true;
+              shellcheck.enable = true;
+              shfmt.enable = true;
+              sqlfluff.enable = true;
+              toml-sort.enable = true;
+              yamlfmt.enable = true;
+              # keep-sorted end
+            };
+          };
+          nix-unit = {
+            inputs = {
+              inherit (inputs)
+                nixpkgs
+                flake-parts
+                nix-unit
+                treefmt-nix
+                ;
+            };
+            tests = {
+              "test example system-specific" = {
+                expr = "1";
+                expected = "1";
+              };
+            };
           };
         };
-        packages.default = pkgs.hello;
-      };
       flake = {
         schemas = inputs.flake-schemas.schemas;
+        templates = rec {
+          base = {
+            description = "nullkomma template";
+            path = ./templates/base;
+            welcomeText = ''
+              Welcome to the nullkomma template
+            '';
+          };
+          default = base;
+        };
+        tests = {
+          "test example system-agnostic" = {
+            expr = "2";
+            expected = "2";
+          };
+          "test template welcome text" = {
+            expr = self.templates.default.description;
+            expected = "nullkomma template";
+          };
+        };
       };
     };
 }

templates/base/.envrc

@@ -0,0 +1,6 @@
+#!/bin/bash
+
+if ! has nix_direnv_version || ! nix_direnv_version 3.0.6; then
+  source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/3.0.6/direnvrc" "sha256-RYcUJaRMf8oF5LznDrlCXbkOQrywm0HDv1VjYGaJGdM="
+fi
+use flake

templates/base/.github/workflows/ci.yml

@@ -0,0 +1,22 @@
+name: CI
+on:
+  pull_request:
+  workflow_dispatch:
+  push:
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+jobs:
+  DeterminateCI:
+    uses: DeterminateSystems/ci/.github/workflows/workflow.yml@main
+    permissions:
+      id-token: "write"
+      contents: "read"
+    with:
+      visibility: public
+  flake-checker:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Check Nix flake Nixpkgs inputs
+        uses: DeterminateSystems/flake-checker-action@v9