Skip to content

Error Reference

Vite DevTools uses structured diagnostics to surface actionable warnings and errors at runtime. Each diagnostic has a unique error code, a human-readable message, and a link back to this documentation.

How error codes work

  • Codes follow the pattern prefix + 4-digit number (e.g., DF0001, DTK0008, RDDT0002).
  • Each prefix maps to a package: DTK for @vitejs/devtools (Vite-specific pieces), RDDT for @vitejs/devtools-rolldown. The framework-neutral devframe package documents its own DF-prefixed codes at the Devframe docs site.
  • Every error page includes the cause, recommended fix, and a reference to the source file that emits it.
  • The diagnostics system is powered by logs-sdk, which provides structured logging with docs URLs, ANSI-formatted console output, and level-based filtering.

DevTools Kit (DTK)

Emitted by @vitejs/devtools and @vitejs/devtools-kit.

CodeLevelTitle
DTK0008warnClient Auth Disabled
DTK0010warnExperimental Static Build
DTK0011errorRPC Function Error
DTK0012errorRPC General Error
DTK0013errorUnauthorized RPC Access
DTK0014errorPlugin Setup Error
DTK0023errorVite Server Required
DTK0028errorPath Outside Workspace Root
DTK0029errorPath Outside Workspace Root
DTK0030errorDock Entry Not Found
DTK0031errorDock Entry Not a Launcher
DTK0032errorDock Launch Error
DTK0050errorDock Already Registered
DTK0051errorCannot Change Dock ID
DTK0052errorDock Not Registered
DTK0053errorTerminal Session Already Registered
DTK0054errorTerminal Session Not Registered
DTK0055errorCommand Already Registered
DTK0056errorCannot Change Command ID
DTK0057errorCommand Not Registered

Rolldown DevTools (RDDT)

Emitted by @vitejs/devtools-rolldown.

CodeLevelTitle
RDDT0001warnRolldown Logs Directory Not Found
RDDT0002warnJSON Parse Stream Bad Line

Released under the MIT License.