downloads
Across all versions, last 30 days.
259,315 in 30 days
compatibility
Runtime metadata.
keywords
Tagged topics.
Across all versions, last 30 days.
259,315 in 30 days
Runtime metadata.
Tagged topics.
Estimated unpacked size across 1 packages.
45.5 kB
Includes dependencies.
Latest published Nov 15, 2026
latest
TypeScript-first developer supertool for Node.js. Run .ts/.tsx files directly on your installed Node, a faster npm run, a pnpm-compatible package manager, and a built-in Node version manager — no config, no lock-in, no nub-specific public APIs.
Documentation: https://nubjs.com/docs
# macOS / Linux
curl -fsSL https://nubjs.com/install.sh | bash
# Windows (PowerShell)
irm https://nubjs.com/install.ps1 | iex
# Or via npm
npm install -g @nubjs/nub# Run TypeScript directly — no tsconfig, no build step
nub server.ts
# Run package.json scripts (faster than npm/pnpm run)
nub run dev
nub run build
# Execute a local or remote binary
nubx vitest --run
# One name for a file, a script, or an installed bin
nubr app.ts
# Watch mode — restart on change
nub watch server.ts.ts, .tsx, .mts, .cts, .jsx execute directly. Enums, decorators, parameter properties, and namespaces are handled. Source maps work in error traces..env loading is built in. Workspace-aware, with ${VAR} expansion and .env.local / .env.production layering.nub run resolves scripts, adds node_modules/.bin to PATH, and runs lifecycle hooks — without the per-invocation Node bootstrap that npm run / pnpm run pay.--no-experimental-*.@lib/utils resolves via compilerOptions.paths with no build step. Extensionless and data-format imports (.jsonc, .json5, .toml, .yaml) work too.Temporal, URLPattern, RegExp.escape, Error.isError, Promise.try, navigator — feature-detected, native wins.nub install / add / remove are pnpm-compatible on the CLI and lockfile-compatible with whatever the project already uses (npm / pnpm / bun round-trip, yarn read-only) — Nub does not impose its own lockfile format.nvm / corepack are not needed.Nub is not a Node fork. It is a Rust CLI that orchestrates your installed Node via Node's own extension surfaces — module.registerHooks(), --import preloads, V8 flag injection, an N-API addon for fast transpilation, and a per-invocation PATH shim. Code targeting Node runs on Nub byte-for-byte. For orchestration without augmentation, use nub run --node.
There are no nub-specific public APIs to import, no nub:* module namespace, and no config field you author named after the tool. Adopting Nub is reversible — the project keeps running under plain Node and your existing package manager.
Nub runs on your installed Node, version 18.19.0 or newer. The fast tier (sync module.registerHooks()) engages on Node 22.15+; versions 18.19–22.14 run in a compatibility tier via async module.register(). Supported platforms: macOS (arm64, x64), Linux (x64, arm64), Windows (x64).
MIT — see LICENSE. Full docs at https://nubjs.com/docs.