feat(layouts): separate layouts for performance and expose page metas

[atinux]

• This avoid double mounted hook on all the components of the displayed page (was a regression from feat: support custom layouts #1187)
• Created header: false and footer: false that a custom Vue page can use in definePageMeta to solve move header and footer to layout #1181
• Updated the documentation

Not sure if this is worth having as breaking change as it is a very advanced usaged.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
docus	Ready	Preview	Oct 6, 2025 8:59am

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/create-docus@1194

npm i https://pkg.pr.new/docus@1194

commit: 3e9a5aa

[sandros94]

This reverts #1187 and forces use definePageMeta on each custom layout and custom page. Am I missing any advantage of having a hardcoded header and footer in the app.vue compared to nested layouts? 🤔

[larbish]

@sandros94 The old way of handling it caused the docs aside to be mounted twice. You can still create your own layout with this implementation and simply disable the header and footer there.

[sandros94]

@sandros94 The old way of handling it caused the docs aside to be mounted twice. You can still create your own layout with this implementation and simply disable the header and footer there.

Rethinking about this, since I never use the provided header and footer, I could simply rewrite them and let Nuxt use the ones from the local project instead of docus' layer. Indeed there should be plenty of workarounds