TypeScript + Nix (pnpm)

SkillDev tools

pnpm + Nix build conventions. Covers fetchPnpmDeps hash management and dependency workflow.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the TypeScript + Nix (pnpm) skill

What this skill tells your AI

The instructions your AI receives, as published by juspay/kolu in .agents/skills/nix-typescript/SKILL.md and read by ahel’s review.

Dependency hash management

nix/modules/typescript.nix uses fetchPnpmDeps with a pinned hash. When pnpm-lock.yaml changes (via pnpm add/remove/update), this hash goes stale and nix build fails.

Fix recipe

  1. Run nix build 2>&1 — it fails with a hash mismatch
  2. Extract the correct hash from the got: sha256-... line in the error
  3. Update the hash = "sha256-..." line in nix/modules/typescript.nix

Parallelization

Run the hash fix in background immediately after pnpm-lock.yaml changes. Don't wait until end of session — kick it off as soon as the lock file is modified, then continue coding. The nix build takes minutes; doing it in background avoids blocking other work.

Build

  • nix build — full production build (client + server bundle)
  • nix run — build and run
  • Client is built with pnpm --filter kolu-client build (Vite)
  • Server runs via tsx (TypeScript execution without compile step)

Signals

GitHub stars
78
Forks
12
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
nix-typescript
Source
github.com/juspay/kolu