Nitro · NITRO0010

Do not use app composables in Nitro server files

Nuxt app composables are not available from Nitro server files.

NITRO0010vite-doctor/nitroservererrorSuggestion

nitro/server/no-client-composablessrc/rule-packs/nitro/rules/no-client-composables-in-server.ts Upstream docs

Run this rule

pnpm vite-doctor . --framework nitro --rules nitro/server/no-client-composables

Why it matters

Server handlers run with Nitro request context, not Vue setup context. App composables like useRoute(), useFetch(), and useHead() depend on the Nuxt app runtime.

Recommended fix

Use event-aware Nitro utilities in server handlers.

Useful links

Rule reference
Nitro handlers

Example

Avoid client composables in server handlers

Before

export default defineEventHandler(() => {
  return useRoute().path
})

After

export default defineEventHandler((event) => {
  return getRequestURL(event).pathname
})