Nuxt Devtools v4.0.0
nuxt/devtoolsBreaking changes
Summary
Nuxt Devtools v4.0.0 introduces significant breaking changes, including the removal of deprecated auth token arguments, @vue/devtools integration, and legacy files. Key features include the upgrade to Vite DevTools, a new Code Server plugin replacing VS Code integration, and a streamlined client UI served as remote assets. The update also focuses on reducing install size and enhancing the overall developer experience with improved notifications and a unified Data Inspector.
Breaking changes in v4.0.0
- Remove deprecated auth token args from builtin RPC functions - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/965 (4418e)
- Remove @vue/devtools integration - by @antfubot and opencode in https://github.com/nuxt/devtools/issues/1056 (a1c92)
- Remove cjs build and legacy dts files - by @antfu (d2c6d)
- devtools:
- Reuse the built-in Terminals dock via ctx.terminals - by @antfubot in https://github.com/nuxt/devtools/issues/1026 (bee6f)
- Finish Messages + terminals convergence on Devframe 0.7.7 - by @antfubot in https://github.com/nuxt/devtools/issues/1032 (c0812)
- Replace server discovery with the Data Inspector plugin - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1034 (35def)
- Make embedded dock the only client mode - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1041 (eb96a)
- Slim the install size of @nuxt/devtools - by @antfubot in https://github.com/nuxt/devtools/issues/1121 (10f9e)
- v4:
- Migrate execa to tinyexec - by @antfu in https://github.com/nuxt/devtools/issues/944 (ae68d)
- Remove global install and wizard package - by @antfu in https://github.com/nuxt/devtools/issues/943 (34d13)
- Always use Vite DevTools, remove floating panel - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/952 (8807b)
Full release notes
🚨 Breaking Changes
- Remove deprecated auth token args from builtin RPC functions - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/965 (4418e)
- Remove @vue/devtools integration - by @antfubot and opencode in https://github.com/nuxt/devtools/issues/1056 (a1c92)
- Remove cjs build and legacy dts files - by @antfu (d2c6d)
- devtools:
- Reuse the built-in Terminals dock via ctx.terminals - by @antfubot in https://github.com/nuxt/devtools/issues/1026 (bee6f)
- Finish Messages + terminals convergence on Devframe 0.7.7 - by @antfubot in https://github.com/nuxt/devtools/issues/1032 (c0812)
- Replace server discovery with the Data Inspector plugin - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1034 (35def)
- Make embedded dock the only client mode - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1041 (eb96a)
- Slim the install size of @nuxt/devtools - by @antfubot in https://github.com/nuxt/devtools/issues/1121 (10f9e)
- v4:
- Migrate execa to tinyexec - by @antfu in https://github.com/nuxt/devtools/issues/944 (ae68d)
- Remove global install and wizard package - by @antfu in https://github.com/nuxt/devtools/issues/943 (34d13)
- Always use Vite DevTools, remove floating panel - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/952 (8807b)
🚀 Features
- Upgrade vite-plugin-inspect to v12, use devtools-kit RPC - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/966 (4c594)
- Replace VS Code integration with Code Server plugin - by @antfu in https://github.com/nuxt/devtools/issues/1036 (239ab)
- Serve the client UI as devframe remote assets via @nuxt/devtools-assets - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1071 (39470)
- Upgrade devframe and Vite DevTools, update branding - by @antfu (42419)
- Upgrade devframe and vite devtools - by @antfu (8ff46)
- Upgrade devframe to v1.0 - by @antfu (96195)
- Update deps - by @antfu (a1fce)
- Add @nuxt/devtools-onboard as the opt-in entry point of Nuxt DevTools - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1117 (ff051)
- Remove Open Graph module and integrate new assets and Open Graph plugins - by @antfu (b4d46)
- Deps on
@nuxt/devtools-assetsfor now to improve the landing experience (as we have the onboard package now) - by @antfu (93820) - Upgrade to
@vitejs/devtoolsv0.8 - by @antfu (c13d0) - Update deps - by @antfu (6ea43)
- deps:
- Migrate to Vite DevTools v0.5.0 and Devframe v0.9.2 - by @antfubot and opencode in https://github.com/nuxt/devtools/issues/1065 (1ff0e)
- devtools:
- Devtools:ready hook + nostics-driven deprecation foundation - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1021 (f9dda)
- Client-side onDevtoolsReady + expose Vite DevTools client; fix client RPC registration - by @antfubot in https://github.com/nuxt/devtools/issues/1023 (88c4f)
- Unify notifications on the devframe Messages system - by @antfubot in https://github.com/nuxt/devtools/issues/1025 (6bfe9)
- Select client Vite context deterministically, add Nuxt dock group - by @antfubot in https://github.com/nuxt/devtools/issues/1031 (6b9bf)
- Project each DevTools tab as its own Vite DevTools dock entry - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1035 (f4fe2)
- Unify Data Inspector Vite instance and refresh builtin queries - by @antfubot in https://github.com/nuxt/devtools/issues/1047 (5a6c4)
- Make vite-plugin-inspect an optional peer dependency - by @antfubot in https://github.com/nuxt/devtools/issues/1055 (c8da2)
- Add
dataInspectoroption + lazy-load integrations - by @antfu in https://github.com/nuxt/devtools/issues/1061 (eeb29) - Respect DO_NOT_TRACK environment variable - by @antfubot in https://github.com/nuxt/devtools/issues/1064 (190ff)
- Proxy client
__connection.jsonto hub in standalone dev - by @antfubot in https://github.com/nuxt/devtools/issues/1070 (4449f) - Drive Vite DevTools through the
devtoolsconfig option on Vite 8.3+ - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1091 (c2867) - Surface the auth code through the Nuxt CLI terminal host - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1093 (73e65)
- Restore Vue DevTools through vite-plugin-vue-devtools v9 - by @antfubot in https://github.com/nuxt/devtools/issues/1099 (86abd)
- playgrounds:
- Add ecosystem dogfooding playground for plan 04 - by @antfubot, opencode and @antfu in https://github.com/nuxt/devtools/issues/1022 (6079f)
🐞 Bug Fixes
- Use compatible radial-gradient syntax in OG image component - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/959 (ce21c)
- Persist async data across tab navigation with custom getCachedData - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/963 (a2010)
- Use literal version ranges in pnpm overrides instead of catalog refs - by @antfubot in https://github.com/nuxt/devtools/issues/1015 (077b2)
- Nuxt api url - by @antfu (0c947)
- Resolve devtools client runtime errors - by @antfu in https://github.com/nuxt/devtools/issues/1075 (7dac1)
- Restore typecheck against nuxt-nightly's typed fetch/hooks API - by @antfubot in https://github.com/nuxt/devtools/issues/1085 (e4217)
- Bump unocss to 66.10.1 to restore DevTools client styling - by @antfubot in https://github.com/nuxt/devtools/issues/1088 (7d7e9)
- Resolve typecheck errors after dependency updates - by @antfubot in https://github.com/nuxt/devtools/issues/1104 (93ffd)
- Accept any nitro version in the optional peer dependency - by @mansurkhoja in https://github.com/nuxt/devtools/issues/1106 (f96b0)
- assets:
- Skip re-declaring services Vite DevTools already installed - by @antfubot in https://github.com/nuxt/devtools/issues/1137 (b7371)
- ci:
- Generate devtools client .nuxt types before typecheck job - by @antfubot and opencode in https://github.com/nuxt/devtools/issues/1089 (1b2c2)
- Build with bumped nightly names before publishing - by @antfubot in https://github.com/nuxt/devtools/issues/1094 (3e65f)
- Build nightly packages before bumping their names - by @antfubot in https://github.com/nuxt/devtools/issues/1095 (ed237)
- client:
- Load virtual files from
/_vfs/for Nitro v3 compatibility - by @antfubot in https://github.com/nuxt/devtools/issues/1132 (e1f30)
- Load virtual files from
- deps:
- Pin vite to 8.0.x (< 8.1) to unbreak DevTools e2e - by @antfubot in https://github.com/nuxt/devtools/issues/1020 (b9b6f)
- Upgrade Vite DevTools to 0.5.1, fix e2e client-context global - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1069 (3d2eb)
- Align the Nuxt nightly with nitro 3.0.260903 so the dev server boots - by @antfubot in https://github.com/nuxt/devtools/issues/1107 (a4928)
- devtools:
- Optimize @vue/devtools dependencies in dev - by @huang-julien in https://github.com/nuxt/devtools/issues/981 (32563)
- Let birpc be singlesource of turth for server<->client comms - by @huang-julien in https://github.com/nuxt/devtools/issues/978 (4853d)
- Run defineViteDevToolsPlugin only for client vite - by @huang-julien in https://github.com/nuxt/devtools/issues/977 (b5f9f)
- Add undeclared
unstoragedependency - by @danielroe in https://github.com/nuxt/devtools/issues/986 (32b43) - Pre-bundle additional injected client deps in dev - by @antfu and Claude Opus 5 (1M context) in https://github.com/nuxt/devtools/issues/991 (48194)
- Reference optimizeDeps in reference to
@nuxt/devtools- by @danielroe in https://github.com/nuxt/devtools/issues/1001 (49d77) - Don't scope dock plugin with
{ server: false }- by @antfu (b2665) - Correct options cache guard and stop mutating defaults - by @antfubot in https://github.com/nuxt/devtools/issues/1018 (f71b1)
- Remove the correct module in uninstallNuxtModule - by @antfubot in https://github.com/nuxt/devtools/issues/1019 (72934)
- Drop stale visibility assertion from nuxt-group e2e test - by @antfubot in https://github.com/nuxt/devtools/issues/1042 (6eeec)
- Prevent StateEditor from freezing the page on live state - by @antfubot in https://github.com/nuxt/devtools/issues/1058 (dbc5d)
- Handle transient RPC failures in getOptions/telemetryEvent - by @antfubot in https://github.com/nuxt/devtools/issues/1072 (40f22)
- Harden RPC surface against traversal, spoofing, and dead auth UI - by @antfubot in https://github.com/nuxt/devtools/issues/1086 (24877)
- Rework timeline function wrapping to run after key injection - by @cernymatej, @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1028 (5d695)
- Resolve open-in-editor paths against the root and workspace dirs - by @lazerg in https://github.com/nuxt/devtools/issues/1098 (e9c70)
- Stop inlining every dependency into the Nitro v2 dev bundle - by @antfubot in https://github.com/nuxt/devtools/issues/1109 (397f9)
- Contain asset RPC paths and the storage denylist to what the UI may touch - by @antfubot and @antfu in https://github.com/nuxt/devtools/issues/1111 (6521d)
- Open Sublime Text with the
sublCLI - by @ahmetomerv in https://github.com/nuxt/devtools/issues/1134 (82eef)
- devtools-kit:
- Pass cwd to execa - by @huang-julien in https://github.com/nuxt/devtools/issues/960 (64958)
- devtools/client:
- Debounce render of NDisconnectIndicator - by @huang-julien in https://github.com/nuxt/devtools/issues/979 (cf8d9)
- e2e:
- Unblock the dev e2e suite after the nuxt-nightly 5x upgrade - by @antfubot in https://github.com/nuxt/devtools/issues/1054 (7b99f)
- Give the tab-seo project a tall viewport so the sidebar dock list doesn't overflow - by @antfubot in https://github.com/nuxt/devtools/issues/1084 (9f596)
- ecosystem:
- Inherit the root pnpm version in the Nuxt 4/5 playgrounds - by @antfubot in https://github.com/nuxt/devtools/issues/1138 (e727f)
- onboard:
- Load DevTools v3, v4 and nightly releases - by @antfubot in https://github.com/nuxt/devtools/issues/1122 (d0b77)
- Confirm installs in nuxi's terminal, on devframe v1.2.6 - by @antfubot in https://github.com/nuxt/devtools/issues/1126 (c12b7)
- Serve embedded.js through Nuxt's Vite dev handler - by @antfubot in https://github.com/nuxt/devtools/issues/1130 (745fa)
- release:
- Use directory-relative turbo filter in prepack scripts - by @antfubot and opencode in https://github.com/nuxt/devtools/issues/1073 (1a77a)
- ui:
- Color mode reactiveness - by @antfu (f7b17)
🏎 Performance
- deps:
- Make
@nuxt/kitpeer deps - by @antfu (b33a2)
- Make
- devtools:
- Move
diffto devDependencies - by @antfu in https://github.com/nuxt/devtools/issues/1060 (5ba4c) - Trim @nuxt/devtools runtime dependencies - by @antfubot in https://github.com/nuxt/devtools/issues/1066 (ca107)
- Move
