v4.0.0 by github-actions[bot] · Pull Request #1482 · nuxt/cli

github-actions · 2026-08-24T07:31:12Z

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 total install size. You can track the current progress here.

👉 Changelog

compare changes

🚀 Enhancements

dev: a terminal host for prompts, tasks and notifications (feat(dev): a terminal host for prompts, tasks and notifications #1488)
dev: warn when the dev server is reachable from the network (40ab1f6)
dev: narrate what a slow startup is waiting on (feat(dev): narrate what a slow startup is waiting on #1478)
dev: interactive terminal ui for the dev server (feat(dev): interactive terminal ui for the dev server #1463)
dev: suggest using nuxt curl when running non-interactively (feat(dev): suggest using nuxt curl when running non-interactively #1464)
dev: stream live startup progress to the loading page and terminal (81a5de1)
offer to rerun with correct spelling of commands/args (36119fe)
docs: add nuxt docs command (f2dbd8c)
module,task: add --json to module search and task list (da95c8b)
suggest the closest command instead of dumping help (b841b87)
warn on unknown options and suggest the intended one (07e7981)
info: add --json output (82fe2d6)
dev: explain first-run failures before nuxt loads (feat(dev): explain first-run failures before nuxt loads #1444)
curl,task: highlight + pretty-print responses (feat(curl,task): highlight + pretty-print responses #1432)
module: show descriptions and highlight matches while searching (e621b9c)
curl,task: add nuxt curl, nuxt task list and nuxt task run (feat(curl,task): add nuxt curl, nuxt task list and nuxt task run #1417)
dev: take over a dev server already running on this project (feat(dev): take over a dev server already running on this project #1414)
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

dev: bind the dev server port before the config is loaded (88de5da)
keep engine and update checks off the version path (a3fa129)
dev: stop saves that change nothing from restarting the dev server (perf(dev): stop saves that change nothing from restarting the dev server #1435)
module: swap fzf for fuzzysort (ff0cc23)
dev,module: handle registry trailing slashes internally (0673103)
dev: use node createHash for hashing build manifest (8ff1c67)
dev: use builtin node SourceMap instead of source-map-js (perf(dev): use builtin node SourceMap instead of source-map-js #1430)
info,upgrade: use confbox rather than pnpm-workspace-yaml (perf(info,upgrade): use confbox rather than pnpm-workspace-yaml #1425)
replace picocolors with node:util styleText (refactor: replace picocolors with node:util styleText #1416)
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

dev: surface boxed prompts + startup warnings on the panel (fix(dev): surface boxed prompts + startup warnings on the panel #1487)
dev: record request urls before middlewares rewrite them (fix(dev): record request urls before middlewares rewrite them #1486)
only report unknown flags that look like a typo (fix: only report unknown flags that look like a typo #1485)
dev: reject unknown Host headers on internal dev endpoints (14c268e)
dev: strip the request attribution header from incoming requests (667f2a8)
dev: omit request headers from the rendered error page (7e69f27)
dev: verify sha-256 checksums for downloaded cloudflared binaries (3ad862d)
docs: reject unsafe tarball members before extraction (dd22149)
dev: stop racing the first render (fix(dev): stop racing the first render #1475)
dev: group routes by kind and label method-less handlers (9d042af)
dev: close the help view with ? as well as h (6f6e530)
abort on ctrl-c at suggestion prompts (34714dc)
dev: properly attribute logs for nitro v3 (fix(dev): properly attribute logs for nitro v3 #1474)
typecheck: document negatable flags (6890367)
dev: handle nuxt v5 for the new interactive ui (fix(dev): handle nuxt v5 for the new interactive ui #1473)
capture: sample fingerprint where output is erased (fix(capture): sample fingerprint where output is erased #1472)
init: pass -- through npm create, document negative flags (5d39ad0)
add value hints to string args (fix: add value hints to string args #1468)
add-template: declare shorthand modifier flags (fix(add-template): declare shorthand modifier flags #1467)
dev: disable timestamps on the project's consola instance (fix(dev): disable timestamps on the project's consola instance #1460)
dev: serve the loading page Nuxt would render, and stop it reloading itself (4d1edb4)
patch citty with hidden, multiple and inherit arg support (fix: patch citty with hidden, multiple and inherit arg support #1457)
init: use a consistent separator in template lists (013f43f)
dev: recommend a CA root instead of disabling TLS verification (4b28edd)
dev: honour a bare --profile flag (4af0dc3)
module: keep the closing bracket when removing consecutive inline entries (14903e5)
module: drop Nuxt 2 leftovers from module search (6d9bc86)
module,upgrade: resolve npmrc credentials as npm does, falling back to npm (ed7c524)
module: refuse to add a config key a spread or computed key could shadow (7ad4e6b)
dev: reject a cloudflared version that escapes the release url or cache (7f02edf)
add: refuse to write a template outside the project (29e69b9)
init: only send GITHUB_TOKEN to github hosts (2a1e5b0)
dev: validate lock and worker metadata before trusting it (53c42f1)
do not mistake a --cwd value for the command (ec34eee)
dev: close the listener when setup fails after binding (967f709)
dev: use a strict port when _PORT is provided to _dev (fix(dev): use a strict port when _PORT is provided to _dev #1456)
dev,info: print nitro version nuxt depends on (fix(dev,info): print nitro version nuxt depends on #1454)
deps: upgrade to fuzzysort v4 (fix(deps): upgrade to fuzzysort v4 #1443)
cli: cap and score-filter module search results (75182da)
start: execute Nitro preview commands faithfully (b80ed9c)
preview: handle listen options and output fallback (0cf1306)
dev: harden listener edge cases (a7add36)
dev: isolate internal test overrides (5eee806)
build: propagate failures and honor bare profile flag (8db925e)
add: respect project registry configuration (e0a6164)
module: harden module management flows (a08a775)
upgrade: handle unsupported dedupe (33de9c8)
upgrade: recreate selected workspace lockfile (292b63a)
typecheck: avoid unnecessary preparation (07d86a3)
test: resolve test utils from project (6ff5c36)
init: handle skipped setup steps (00b2828)
info: make project reporting resilient (9022816)
devtools: harden wizard invocation (b6f2690)
cleanup: make directory removal safe and reliable (9e3b1cb)
analyze: guard builds and simplify serving (23a5a6c)
add-template: expose template options (50e71e5)
cli: align Node warning with package engines (634eeb7)
cli: preserve local command failures (abfd7eb)
dev: await close hooks on shutdown + warn on hanging processes (fix(dev): await close hooks on shutdown + warn on hanging processes #1424)
dev: restore isolated environment host defaults (fix(dev): restore isolated environment host defaults #1422)
dev: show loading screen in initial startup (fix(dev): show loading screen in initial startup #1421)
⚠️ init: drop init command from @nuxt/cli (fix(init)!: drop init command from @nuxt/cli #1420)
dev: fall back to the project's loading template (fix(dev): fall back to the project's loading template #1419)
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

share terminal background and brand colour detection (refactor: share terminal background and brand colour detection #1459)
report first-run and lock failures as actionable errors (refactor: report first-run and lock failures as actionable errors #1445)
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)

📖 Documentation

mention requirements (53f3342)
correct conditional behaviour (c25d392)
correct dev, analyze and init command details (41a9fe5)
update docs for current v4 (docs: update docs for current v4 #1471)
move cli documentation into repository (docs: move cli documentation into repository #1465)

🏡 Chore

bump uppt to v0.6.7 (fb86ed4)
add a terminal capture harness and scenario fixtures (chore: add a terminal capture harness and scenario fixtures #1461)
add a comparison benchmark harness (chore: add a comparison benchmark harness #1458)
lint (51b98e0)
note that init rejects where load reports (841fbc1)
remove narration comments (99c0bb8)
keep generated templates when the starter repo is unreachable (chore: keep generated templates when the starter repo is unreachable #1447)
log manifest hash change before clearing build dir (585278a)
exempt first-party packages from pnpm minimumReleaseAge (chore: exempt first-party packages from pnpm minimumReleaseAge #1434)
add new binary paths for nightly release (af14cc8)
⚠️ bump node versions to support native typescript importing (4360712)
bump pnpm version (2bdae69)

✅ Tests

freeze clock when testing startup logs (eacb946)
mark bun websockets as supported + fix animation detection (63b5b7f)
stop collecting scaffolded command fixtures as test files (a36ce44)
stop the command e2e suite mutating the shared playground (bd19413)
cover dev initialize wiring, close ordering and profiling (e32ea88)
cover typecheck checker selection, install advice and build mode (1e3e803)
cover upgrade preconditions, install failures and the pnpm catalog path (e12e139)
cover the interactive init flow and its fallbacks (f8338be)
cover the dev command takeover, handover and fork pool paths (8112e50)
assert config edits hold their invariants across config shapes (672c101)
cover the dev server lifecycle with a stubbed kit (dd68ab8)
assert nuxt info reports config keys without their values (0b45675)
cover registry auth scoping and dev server responses (3a5aa2c)
cover console raw mode, config loading and info box formatting (ff8529a)
cover error page rendering, cleanup guards and dev listen options (e991256)
give servers under test a realistic startup budget (f1a664b)
cover the banner path with a single version to join (a1a4cb9)
give each dev fixture its own vite cache (e35dd95)
generate: cover build overrides (f850a17)
isolate runtime e2e ports in dev tests and fix force-kill (d05718d)
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

update uppt to 0.6.5 and add prerelease trigger (46d0bef)
only publish nightly releases from main (45a5d8f)
run against 3.x branch as well (f1fcd22)
trigger ci/lint jobs on merge group (9a95204)
run pr benchmark against main (9dfa22b)
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

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

pkg-pr-new · 2026-08-24T07:46:14Z

nuxt-cli-playground

npm i https://pkg.pr.new/create-nuxt@1482

npm i https://pkg.pr.new/nuxi@1482

npm i https://pkg.pr.new/@nuxt/cli@1482

commit: 489c15f

github-actions · 2026-08-24T07:46:44Z

CLI benchmark

@nuxt/cli v3.37.0 (baseline) vs v4.0.0 (this PR)

Metric	baseline v3.37.0	head v4.0.0	Delta
`nuxt --version` wall time (median)	66 ms	63 ms	-4.9%
`nuxt --help` wall time (median)	137 ms	137 ms	-0.4%
`nuxt dev --help` wall time (median)	103 ms	102 ms	-0.9%
`nuxt --version` modules loaded	38	38	0.0%
`nuxt --help` modules loaded	135	135	0.0%
`nuxt dev --help` modules loaded	80	80	0.0%
Installed `node_modules`	2.32 MB	2.32 MB	-0.0%
Published tarball (packed)	264.7 kB	264.7 kB	0.0%

Full report

`@nuxt/cli` v3.37.0 (baseline) vs v4.0.0 (head)

Setting	Value
Baseline	`ref:fb86ed4b60b43603c76f6b18ff976b5440a29dbe` (v3.37.0)
Head	local `packages/nuxt-cli` at `b736794` (v4.0.0)
Node	v24.19.0
OS	Linux 6.17.0 (kernel 6.17.0-1022-azure)
CPU	AMD EPYC 7763 64-Core Processor x 4
Memory	15.6 GB
Load average at start	1.40, 0.44, 0.15
Run started	2026-08-24T07:46:08.010Z

Cold CLI startup

Median of 15 interleaved runs per command, one warmup discarded.

Command	baseline v3.37.0 median	head v4.0.0 median	Delta	baseline v3.37.0 min / p95	head v4.0.0 min / p95
`nuxt --version`	66 ms	63 ms	-4.9%	62 ms / 69 ms	61 ms / 66 ms
`nuxt --version` (first output byte)	62 ms	59 ms	-5.2%	58 ms / 65 ms	57 ms / 62 ms
`nuxt --help`	137 ms	137 ms	-0.4%	132 ms / 139 ms	133 ms / 139 ms
`nuxt --help` (first output byte)	133 ms	132 ms	-0.4%	127 ms / 134 ms	128 ms / 133 ms
`nuxt dev --help`	103 ms	102 ms	-0.9%	101 ms / 107 ms	100 ms / 107 ms
`nuxt dev --help` (first output byte)	99 ms	97 ms	-1.2%	96 ms / 102 ms	96 ms / 102 ms
`nuxt <unknown-command>` (no-op)	147 ms	146 ms	-0.3%	144 ms / 150 ms	142 ms / 148 ms
`nuxt <unknown-command>` (no-op) (first output byte)	142 ms	141 ms	-0.6%	139 ms / 145 ms	137 ms / 143 ms

Module load cost

Counted with a module.registerHooks load hook, compile cache disabled. Counts every JS module actually evaluated on that code path (built-ins excluded, native addons excluded).

Command	baseline v3.37.0 modules	head v4.0.0 modules	Delta	baseline v3.37.0 source bytes	head v4.0.0 source bytes	Delta
`nuxt --version`	38	38	0.0%	291.7 kB	291.7 kB	-0.0%
`nuxt --help`	135	135	0.0%	976.8 kB	976.8 kB	-0.0%
`nuxt dev --help`	80	80	0.0%	586.0 kB	586.0 kB	-0.0%

Install footprint and published tarball

Each version installed on its own into an empty project with nothing but @nuxt/cli as a dependency, so the tree is exactly the CLI and its transitive dependencies. npm cache is warm and the registry is only consulted for metadata, so install wall time is indicative, not a network benchmark.

Metric	baseline v3.37.0	head v4.0.0	Delta
Direct dependencies of `@nuxt/cli`	21	21	0.0%
Packages in the installed tree (unique name@version)	34	34	0.0%
Unique package names	34	34	0.0%
Package directories on disk (cross-check)	28	28	0.0%
Installed `node_modules` on disk	2.32 MB	2.32 MB	-0.0%
Installed files	419	419	0.0%
Install wall time (warm npm cache, median of 3)	690 ms	689 ms	-0.1%
Published tarball (packed)	264.7 kB	264.7 kB	0.0%
Published tarball (unpacked)	921.5 kB	921.5 kB	-0.0%
Files in tarball	131	131	0.0%

Interleaved runs on a shared runner: trust the deltas, not the absolute timings. The dev, restart and build suites run locally via pnpm bench:cli.

codspeed-hq · 2026-08-24T07:48:15Z

Merging this PR will not alter performance

✅ 2 untouched benchmarks

_{Comparing release/v4.0.0 (489c15f) with main (fb86ed4)}

v4.0.0

489c15f

danielroe closed this Aug 24, 2026

danielroe reopened this Aug 24, 2026

Navigation Menu

Uh oh!

v4.0.0 - #1482

v4.0.0#1482
github-actions[bot] wants to merge 1 commit into
mainfrom
release/v4.0.0

github-actions Bot commented Aug 24, 2026 •

edited

Loading

Uh oh!

pkg-pr-new Bot commented Aug 24, 2026

Uh oh!

github-actions Bot commented Aug 24, 2026

`@nuxt/cli` v3.37.0 (baseline) vs v4.0.0 (head)

Cold CLI startup

Module load cost

Install footprint and published tarball

Uh oh!

codspeed-hq Bot commented Aug 24, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

github-actions Bot commented Aug 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎉 Highlights

Breaking changes

Performance

👉 Changelog

🚀 Enhancements

🔥 Performance

🩹 Fixes

💅 Refactors

📖 Documentation

🏡 Chore

✅ Tests

🤖 CI

🎉 New Contributors

❤️ Contributors

Uh oh!

pkg-pr-new Bot commented Aug 24, 2026

Uh oh!

github-actions Bot commented Aug 24, 2026

CLI benchmark

@nuxt/cli v3.37.0 (baseline) vs v4.0.0 (head)

Cold CLI startup

Module load cost

Install footprint and published tarball

Uh oh!

codspeed-hq Bot commented Aug 24, 2026

Merging this PR will not alter performance

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

github-actions Bot commented Aug 24, 2026 •

edited

Loading

`@nuxt/cli` v3.37.0 (baseline) vs v4.0.0 (head)