Doctor

Catch the AI slop your agents ship.

Doctor scans your project before review and flags framework bugs agents often miss.

~/your-app

pnpm dlx vite-doctor . --rules nuxt/hydration

Detected: Nuxt 4.4.6 + Vue 3.5.35

Runtime: Nuxt 4.4.6 → Nitro 2.13.4 → H3 1.15.11

Confidence: 4 proven, 2 probable

NUXT0029

window is browser-only and this file can run during SSR.

app/components/IssuePanel.vue:14:15

NUXT0031

This template branches on client-only state during SSR.

app/components/IssuePanel.vue:3:5

4 errors2 warnings0 safe fixes available
Catch framework bugs before review
Find hydration, reactivity, config, and server issues while they are cheap to fix.
Use the workflow you already trust
Run the same checks your project already uses, locally or in CI.

Nuxt 5 migration

Plan the Nuxt 5 migration before the version bump.

Vite Doctor checks your current app against Nuxt 5, Nitro 3, and H3 v2, separating what you can fix now from what must land with the upgrade.

~/your-app

pnpm dlx vite-doctor migrate . --to nuxt@5

Target: nuxt@5 from Nuxt 4.4.6 → Nitro 2.13.4 → H3 1.15.11

Fix now on the installed runtime

NITRO0014

nitropack/config is not a supported Nitro 3 import.

→ import defineConfig from "nitro"

NITRO0016

sendRedirect(event, ...) is an H3 v2 compatibility API.

→ return redirect(location, status)

Land with the upgrade

nuxt

4.4.6 → nuxt@5, future.compatibilityVersion 5

NUXT0073

Compatibility 5 ignores unhead.legacy.

Compatibility 5 ignores experimental.parseErrorData.

4 diagnostics2 dependency and config changes

Framework installation

Use the docs that match the diagnostic prefix.

Doctor keeps Nuxt, Vue, Vite, and Nitro in separate rule packs. Choose the framework page first, then open the rule page for the exact diagnostic you are fixing.