v4.0.0

[github-actions]

v4.0.0 is the next major release.

Timetable: to be announced.

🎉 Highlights

Nuxt CLI v4 is a performance, feature and DX-focused release.

Watch this space to keep up-to-date on what's coming! 🔥

Breaking changes

We're taking the opportunity to adopt the following breaking changes:

• we're dropping support for @nuxt/bridge (as Nuxt 2 has been EOL for some time now).
• we now require Node v22.19+, v24.11+, or v26+

Performance

We're working to reduce the dependency count and install size. You can track the current progress here.

👉 Changelog

compare changes

🚀 Enhancements

• improve upgrade hints + add init hint/tip (feat: improve upgrade hints + add init hint/tip #1406)
• dev: print changed nuxt.config keys on a config-triggered reload (feat(dev): print changed nuxt.config keys on a config-triggered reload #1403)
• dev: report why the dev server reloaded or restarted (feat(dev): report why the dev server reloaded or restarted #1402)
• dev: surface the stackblitz editor url in the dev url block (62a030f)
• dev: hint about --host when bound to loopback in docker or wsl (29558d5)
• add: support adding layers via cli (feat(add): support adding layers via cli #1399)
• support pnpm catalogs (feat: support pnpm catalogs #1397)
• build: report total build time (3d16e4c)
• nuxi: defer subcommands to the project's @nuxt/cli (feat(nuxi): defer subcommands to the project's @nuxt/cli #1394)
• init: opt yarn projects out of plug'n'play (64b4525)
• nudge when a newer nuxt release is available (feat: nudge when a newer nuxt release is available #1393)
• suggest proxy-aware retry command when network fails (feat: suggest proxy-aware retry command when network fails #1387)
• dev: add restart, url, qr and copy shortcuts (bf72c89)
• dev: support opening a custom path or url (f693d33)
• dev: add --strictPort flag (b6ee3b9)
• dev: respect BROWSER env when opening browser (c1c6687)
• dev: add q and quit shortcuts to dev server (feat(dev): add q and quit shortcuts to dev server #1378)
• dev: detect portless proxy urls (a0eace5)
• dev: better errors inspired by nitro (feat(dev): better errors inspired by nitro #1383)

🔥 Performance

• keep youch, the registry and the update check off startup (perf: keep youch, the registry and the update check off startup #1413)
• disable mimalloc eager arena commit at cli entry (perf: disable mimalloc eager arena commit at cli entry #1411)
• ⚠️ nuxi: defer to project cli + drop nuxt <3.26 support (perf(nuxi)!: defer to project cli + drop nuxt <3.26 support #1410)
• nuxi: do not bundle jiti (perf(nuxi): do not bundle jiti #1409)
• dev: warm a single fork by default, overridable with NUXT_DEV_FORK_POOL_SIZE (1897968)
• dev: warm the fork pool on first file change instead of on ready (9a10f71)

🩹 Fixes

• correctly report Vite version when using Vite+ (fix: correctly report Vite version when using Vite+ #1415)
• dev: do not restart when a client aborts a connection (fix(dev): do not restart when a client aborts a connection #1412)
• do not read the project manifest when a dependency is missing (aeb022e)
• dev: trace youch into dist so its assets ship with the build (fix(dev): trace youch into dist so its assets ship with the build #1407)
• dev: do not end the dev session when a replaced fork exits non-zero (4538067)
• resolve npm auth token from parseINI result (ec6b08a)
• dev: handle a rejected reusePort option and a failed cold restart (ae9be91)
• dev: keep serving during a hard restart using SO_REUSEPORT (fix(dev): keep serving during a hard restart using SO_REUSEPORT #1404)
• dev: drain connections before force-closing the dev server (678348a)
• dev: omit default ports and decode urls in the dev url block (682c773)
• dev: warn on invalid --host and explain failed binds (98dcb1c)
• dev: keep warming the pool once the app is served by a fork (f93bd1d)
• dev: track cold forks in the pool so shutdown reaps them (dfef70f)
• dev: reap every pooled fork on shutdown (c16f02b)
• dev: bind directly with --strictPort and translate bind errors (747c898)
• analyze: skip prerendering routes when building (fix(analyze): skip prerendering routes when building #1400)
• paths: emit clickable hyperlinks for printed paths (27d8296)
• don't mistake another package.json for nuxt's own (79a829d)
• dev: unpause stdin when using clack spinners on windows (fix(dev): stdin paused when using clark spinners on Windows #1395)
• stop forcing --no-clear on programmatic commands (2043313)
• dev: take us out of raw mode after clack finishes (5ef1f1b)
• match exsolve resolution errors when @nuxt/kit is missing (e7aa760)
• init: print cd step for single-character project directories (9ff68d9)
• dev: strip windows working directory from rendered errors (f6e9235)
• upgrade: take ownership of dependency installation (a04ec72)
• preview: declare serve as an optional peer dependency (846ebd5)
• dev: settle in-flight responses when nuxt reloads (fix(dev): settle in-flight responses when nuxt reloads #1392)
• upgrade: find lockfile in nearest directory, not workspace root (fix(upgrade): find lock file in nearest directory, not workspace root #1391)
• dev: open inspector only in the process serving the app (fix(dev): open inspector only in the process serving the app #1388)
• typecheck: only imply --build for solution-style tsconfigs (fix(typecheck): only imply --build for solution-style tsconfigs #1390)
• _dev,start: hide _dev and start commands from help output (fix(_dev,start): hide _dev and start commands from help output #1389)
• remove duplicate, prefer 'nuxt' + add help snapshots (f9af294)
• dev: warn when a browser cannot be opened and caption qr codes (f1c378d)
• dev: do not report or restart on broken pipes (66d21bd)
• dev: ignore link-local addresses in network urls (56c1eb7)
• init: make dependency install recoverable and package-manager aware (fix(init): make dependency install recoverable and package-manager aware #1386)
• dev: pin cloudflared version and shut tunnels down gracefully (0027fb2)
• dev: hide timestamp and remove outdated filters (cff4db2)

💅 Refactors

• module: edit nuxt.config modules with oxc instead of magicast (97ded7d)
• fetch JSON with native fetch instead of ofetch (ea82130)
• info: load nuxt.config natively and make jiti an optional peer (669bc5e)
• module: search with fzf instead of fuse.js (297bf24)
• dev: use source-map-js to map error frames (4582c22)
• create-nuxt: bundle citty instead of depending on it (51849b8)
• normalise on rootDir in most usages (refactor: normalise on rootDir in most usages #1398)
• module: directly use magicast to update nuxt config (refactor(module): directly use magicast to update nuxt config #1396)
• extract npm registry resolution into a shared util (571cc3a)
• move source of truth from nuxi to @nuxt/cli (refactor: move source of truth from nuxi to @nuxt/cli #1385)
• dev: use internal listener (refactor(dev): use internal listener #1382)
• use picocolors (17b2d02)
• migrate from semver to verkit (refactor: migrate from semver to verkit #1379)
• replace debug with obug (refactor: replace debug with obug #1372)

🏡 Chore

• add new binary paths for nightly release (af14cc8)
• ⚠️ bump node versions to support native typescript importing (4360712)
• bump pnpm version (2bdae69)

✅ Tests

• give each dev spec its own fixture copy (fcfd1bf)
• stub provider and environment detection in dev output tests (d5c583e)
• use file URL when importing loader in subprocess (b6f5b11)
• fix types (a94b9f5)
• cover shortcut error paths (0e780ba)
• assert on rendered terminal output with ansivision (1754688)

🤖 CI

• set explicit permissions and avoid interpolation (ae1dfc2)
• set persist-credentials to false (09c49c4)
• also rename provenance workflow (df44f64)
• rename bench workflow (3798e0e)
• improve workflows (ci: improve workflows #1381)

🎉 New Contributors

• Norbiros (@Norbiros)
• Michał Kędrzyński (@kedrzu)
• Joaquín Sánchez (@userquin)
• Luke Nelson (@luc122c)

❤️ Contributors

• Norbiros (@Norbiros)
• Michał Kędrzyński (@kedrzu)
• Daniel Roe (@danielroe)
• Joaquín Sánchez (@userquin)
• Luke Nelson (@luc122c)