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 nostics, which provides structured diagnostic codes with docs URLs and ANSI-formatted console output.

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

Hub-side diagnostics for docks, terminals, messages, and commands live upstream in @devframes/hub under the DF8xxx range — see the Devframe error reference.

Rolldown DevTools (RDDT)

Emitted by @vitejs/devtools-rolldown.

CodeLevelTitle
RDDT0001warnRolldown Logs Directory Not Found
RDDT0002warnRolldown Log Reader Bad Line

Released under the MIT License.