devshell: Add docs Markdown previewer

Wraps `go-grip` to preview docs in the browser before pushing, rendered locally with live reload. Defaults to `docs/README.md`. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 15:27:37 +00:00
parent 2606d0e4ae
commit 60324c5ff5
3 changed files with 13 additions and 0 deletions
@@ -59,6 +59,17 @@ in
      help = "SSH to a machine by NixOS system or home-manager config name";
      command = ''exec ${sshMachine}/bin/ssh-machine "$@"'';
    }
+    {
+      name = "docs";
+      category = "utilities";
+      help = "Preview Markdown docs in the browser (default: `docs/README.md`)";
+      command = ''
+        if [ $# -eq 0 ] || [[ "$1" == -* ]]; then
+          set -- "$PRJ_ROOT/docs/README.md" "$@"
+        fi
+        exec ${pkgs.go-grip}/bin/go-grip "$@"
+      '';
+    }
    {
      name = "json2nix";
      category = "utilities";