Nuxt · NUXT0002

Do not shadow Docus app.vue with an empty app shell

Flags empty app vue shadow in Docus layers code before it leaks into runtime behavior.
NUXT0002vite-doctor/docuslayerserrorSuggestion
docus/layers/no-empty-app-vue-shadowsrc/rule-packs/nuxt/rules/docus.ts

Run this rule

pnpm nuxt doctor --rules docus/layers/no-empty-app-vue-shadow

Why it matters

Docus gives this pattern a specific contract. Staying inside that contract makes the code easier to test, refactor, and run across server and client runtimes.

Remove empty app vue shadow, or move it to the Docus runtime/API that owns that behavior.

Example

Avoid empty app.vue shadow

Before

<template>
  <NuxtPage />
</template>

After

<template>
  <DocusLayout>
    <NuxtPage />
  </DocusLayout>
</template>
Copyright © 2026