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:
DTKfor@vitejs/devtools(Vite-specific pieces),RDDTfor@vitejs/devtools-rolldown. The framework-neutraldevframepackage documents its ownDF-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.
| Code | Level | Title |
|---|---|---|
| DTK0008 | warn | Client Auth Disabled |
| DTK0010 | warn | Experimental Static Build |
| DTK0011 | error | RPC Function Error |
| DTK0012 | error | RPC General Error |
| DTK0013 | error | Unauthorized RPC Access |
| DTK0014 | error | Plugin Setup Error |
| DTK0023 | error | Vite Server Required |
| DTK0028 | error | Path Outside Workspace Root |
| DTK0029 | error | Path Outside Workspace Root |
| DTK0030 | error | Dock Entry Not Found |
| DTK0031 | error | Dock Entry Not a Launcher |
| DTK0032 | error | Dock 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.
| Code | Level | Title |
|---|---|---|
| RDDT0001 | warn | Rolldown Logs Directory Not Found |
| RDDT0002 | warn | Rolldown Log Reader Bad Line |