Nuxt · Layers

NUXT0002Do 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.

Why it happens

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.

Fix

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>

Verify the fix

Run only this rule after editing so the report stays focused on the diagnostic you are closing:

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