Packages Node.js applications as reproducible Nix derivations using modern npm, pnpm, and bun build patterns.
This skill provides expert guidance for converting JavaScript and TypeScript projects into native Nix packages for NixOS or nix-darwin environments. It helps developers navigate the decision tree for different lockfile formats, implements best practices for buildNpmPackage and fetchPnpmDeps, and manages complex scenarios like monorepos, native C++ modules requiring node-gyp, and TypeScript build steps. By automating the hash generation workflow and avoiding deprecated tools, it ensures reliable, sandboxed builds for CLI tools and system services.
Key Features
01Standardized templates for pnpm 8/9/10 packaging with manual derivation assembly
02Automated workflow for resolving src and dependency hashes via the Nix error-loop
03Native module support for node-gyp dependencies like better-sqlite3 and sharp
04Integration patterns for nix-darwin and Home Manager configurations
050 GitHub stars
06Decision logic for choosing between buildNpmPackage, fetchPnpmDeps, and importNpmLock approaches
Use Cases
01Integrating JavaScript-based services into a reproducible nix-darwin environment
02Converting a pnpm monorepo into a sandboxed Nix derivation for production deployment
03Packaging a TypeScript CLI tool as a globally available command on a NixOS system
