Nitro · NITRO0001

Do not use navigateTo in Nitro routes

Nitro handlers should redirect with server response utilities instead of Nuxt app navigation.
NITRO0001vite-doctor/nitroservererrorSuggestion
nitro/context/no-navigateto-in-nitrosrc/rule-packs/nitro/rules/no-navigate-to-in-nitro.ts

Run this rule

pnpm vite-doctor . --framework nitro --rules nitro/context/no-navigateto-in-nitro

Why it matters

navigateTo() is a Nuxt app navigation helper. Nitro handlers need to write an HTTP redirect response for the current request event.

Return the redirect response supported by the installed H3 runtime from the Nitro handler.

Example

Avoid navigateTo in Nitro

Before

export default defineEventHandler(() => {
  return navigateTo('/login')
})

After

export default defineHandler(() => {
  return redirect('/login')
})
Copyright © 2026