Post

Introducing Nub. The all-in-one JavaScript toolkit that augments Node.js (instead of trying to replace it)

Node.js now provides a powerful set of extension mechanisms that (mostly) didn't exist when Deno/Bun started: 👉 preload scripts (--import) 👉 module resolution plugins (module.registerHooks) 👉 Node-API native addons

Nub uses these to add Bun's best features on top of stock Node.js ✅ non-erasable TS syntax (e.g. enums) ✅ TS-friendly module resolution (tsconfig-paths, extensionless imports) ✅ JSX ✅ decorators ✅ .env autoloading ✅ yaml/toml imports ✅ `Worker` ✅ `using` ✅ a lot more

When you run a file, Nub detects your project's Node version, auto-installs it if needed, and runs your code with it (no nvm/fnm needed) — including all the augmentations above It respects (in order) 👉 package.json#devEngines 👉 .node-version 👉 .nvmrc 👉 package.json#engines

The `nub` command is flag-for-flag and var-for-var compatible with `node` (via passthrough, primarily)

And because it uses Node itself under the hood, there are no unexpected behavioral divergences. Here's how it does on Deno's Node.js compatibility test suite:

nub run — a 24x faster than pnpm run 🐇 14ms overhead vs >300ms (commands feel instantaneous) 🧱 monorepo friendly (-r/--filter) 🧩 flag-for-flag compatible with pnpm run

nubx — a 19x faster npx 🐇 11ms overhead (vs 200ms+ for npx) 🧩 flag-for-flag compatible with npx ☁️ local-first, falls back to dlx

nub install — a fast, secure, incrementally adoptable package manager 🐇 2.7x faster than pnpm (warm install) 🧩 pnpm-compatible CLI (muscle memory) 🌅 powered by the Aube engine (by @jdx.dev)

Good starting point. There's more to do in security configuration. Consider outsourcing that part to www.npmjs.com/package/@lav... when I release 1.0 We should chat about the integration point. In npm and pnpm I'm plugging into script running for some added security (more coming down the pipeline)

Nub detects your existing package manager (via package.json or lockfile) and runs in COMPAT MODE 🔐 reads *and writes* your existing lockfile (roundtrip!) ⚙️ respects your config files (see chart) ⚡️ zero config changes required in 99% of cases (Nub aborts when unsupported config is detected)

nub pm shim — A built-in package manager shimmer Like `corepack enable`, this registers global shims for npm, yarn, and pnpm. These shims intercept your commands and: - Detect the version used in your project - Install that version if needed - Run the command using the proper version

Nub is now in public beta. Lots more on the roadmap, stay tuned! Star/watch the repo! 👇 github.com/nubjs/nub