← Blog
The Nub Team

Nub 0.2.7

Restores the upgrade path for sidecar-era 0.1.x installs, with warm-install store reuse, a lockfile-compatibility guard, and a watch-mode env-file fix.

This release restores the nub upgrade path for sidecar-era 0.1.x installs, with warm-install store reuse, a lockfile-compatibility guard, and a runtime fix alongside.

Important

nub upgrade from a sidecar-era 0.1.x now works. Older 0.1.x builds shipped a separate runtime directory and their upgrader swaps it on every upgrade; the bin-only archives 0.2.x publishes no longer carried that directory, so nub upgrade hard-failed. The 0.2.7 archives now include a vestigial empty runtime directory so the old upgrader's swap completes — the 0.2.x binary ignores it, since its runtime is embedded. If you are on a sidecar-era 0.1.x, nub upgrade to 0.2.7 or later now succeeds. (#223)

Performance

Warm installs reuse the content-addressed store more reliably, and the hoisted layout links faster.

AreaWhat changed
Hoisted linkerWhole-directory clonefile plus parallel fill for the hoisted layout (#222)
Store reuseA root-key index for no-integrity packages so warm installs reuse the store (#220, #221)

Package manager and runtime

  • nub install aborts with a clear error on unresolvable yarn.lock sources and Yarn Plug'n'Play projects, rather than producing an incorrect install. (#217)
  • nub watch re-reads .env across restarts, so edits to environment files take effect on the next restart. (#214, closes #207)

CLI and distribution

  • Git-style external subcommand dispatch — nub <verb> resolves a nub-<verb> executable on PATH. (#200)
  • A winget manifest, with release-time submission to winget-pkgs. (#213)

The full release notes list every change in this release.

Get started

Or paste this "Get Started" prompt into an agent. It will install Nub and explain how it can be used in your project. (It won't make any changes without permission.)