.gitignore

@@ -9,6 +9,11 @@ node_modules/
 # Podman / Compose
 .env.podman
 
+# Nix
+.direnv/
+.result
+result
+
 # logs
 npm-debug.log*
 yarn-debug.log*

README.md

@@ -15,6 +15,28 @@ All commands are run from the root of the project, from a terminal:
 | `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
 | `npm run astro -- --help` | Get help using the Astro CLI                     |
 
+## Dependency update guidance
+
+For security/deprecated remediation, allow breaking changes via `npm audit fix --force`, then verify:
+
+- `npm audit`
+- `npm run build`
+
+## Nix devshell (recommended)
+
+If you use Nix, you can enter a dev shell that provides the required CLI tools for this repo:
+
+```sh
+nix develop
+```
+
+This is intended to provide tools like Forgejo CLI (`fj`) and Node.js so "when you enter the repo, everything is available":
+
+```sh
+nix develop --command fj version
+nix develop --command node --version
+```
+
 ## Podman (container) development
 
 This repo can be developed inside a Podman container to keep your host clean and improve reproducibility.

flake.lock

@@ -0,0 +1,61 @@
+{
+  "nodes": {
+    "flake-utils": {
+      "inputs": {
+        "systems": "systems"
+      },
+      "locked": {
+        "lastModified": 1731533236,
+        "narHash": "sha256-l0KFg5HjrsfsO/JpG+r7fRrqm12kzFHyUHqHCVpMMbI=",
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "rev": "11707dc2f618dd54ca8739b309ec4fc024de578b",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "flake-utils",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1769598131,
+        "narHash": "sha256-e7VO/kGLgRMbWtpBqdWl0uFg8Y2XWFMdz0uUJvlML8o=",
+        "owner": "NixOS",
+        "repo": "nixpkgs",
+        "rev": "fa83fd837f3098e3e678e6cf017b2b36102c7211",
+        "type": "github"
+      },
+      "original": {
+        "owner": "NixOS",
+        "ref": "nixos-25.11",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "flake-utils": "flake-utils",
+        "nixpkgs": "nixpkgs"
+      }
+    },
+    "systems": {
+      "locked": {
+        "lastModified": 1681028828,
+        "narHash": "sha256-Vy1rq5AaRuLzOxct8nz4T6wlgyUR7zLU309k9mBC768=",
+        "owner": "nix-systems",
+        "repo": "default",
+        "rev": "da67096a3b9bf56a91d16901293e51ba5b49a27e",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-systems",
+        "repo": "default",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

flake.nix

@@ -0,0 +1,23 @@
+{
+  description = "Naputo blog devshell";
+
+  inputs = {
+    # Use stable nixpkgs for a more predictable toolchain.
+    nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.11";
+    flake-utils.url = "github:numtide/flake-utils";
+  };
+
+  outputs = { self, nixpkgs, flake-utils }:
+    flake-utils.lib.eachDefaultSystem (system:
+      let
+        pkgs = import nixpkgs { inherit system; };
+      in
+      {
+        devShells.default = pkgs.mkShell {
+          packages = with pkgs; [
+            forgejo-cli
+            nodejs
+          ];
+        };
+      });
+}

package.json

@@ -10,21 +10,22 @@
   },
   "dependencies": {
     "@astrojs/preact": "^4.1.3",
-    "@astrojs/rss": "^4.0.14",
+    "@astrojs/rss": "^4.0.15",
-    "astro": "^5.7.5",
+    "astro": "^5.17.1",
-    "preact": "^10.28.0"
+    "preact": "^10.28.3"
   },
   "devDependencies": {
-    "@astrojs/language-server": "^2.16.2",
+    "@astrojs/language-server": "^2.13.4",
     "@astrojs/ts-plugin": "^1.10.6",
+    "@typescript-eslint/eslint-plugin": "^8.54.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "astro-eslint-parser": "^1.2.2",
+    "eslint": "^9.39.2",
+    "eslint-plugin-astro": "^1.5.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
     "typescript": "^5.9.3",
     "typescript-language-server": "^5.1.3",
-    "@typescript-eslint/parser": "^8.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.0.0",
-    "eslint-plugin-react": "^7.35.0",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-astro": "^1.5.0",
-    "astro-eslint-parser": "^1.2.2",
     "vscode-langservers-extracted": "^4.10.0"
   }
 }