Nuxt/examples/custom-layouts/README.md

Layouts

Nuxt.js allows you to extend the main layout or create custom layout by adding them in the layouts/ directory

layouts/default.vue

You can extend the main layout by adding a layouts/default.vue file.

Make sure to add the <nuxt> component when creating a layout to display the page component.

The default layout source code is:

<template>
  <nuxt/>
</template>

layouts/error.vue

You can customize the error page by adding a layouts/error.vue file.

This layout is special since your should not include <nuxt/> inside its template, see this layout as a component displayed when an error occurs (404, 500, etc).

The default error page source code is available on: https://github.com/nuxt/nuxt.js/blob/master/lib/app/components/nuxt-error.vue

layouts/*.vue

See the demonstration video.

Every file (first level) in the layouts/ directory will create a custom layout accessible with the layout property in the page component.

Make sure to add the <nuxt> component when creating a layout to display the page component.

Example of layouts/blog.vue:

<template>
  <div>
    <div>My blog navigation bar here</div>
    <nuxt/>
  </div>
</template>

And then in pages/posts.vue I can tell Nuxt.js to use this custom layout:

<script>
export default {
  layout: 'blog'
}
</script>

Demo

npm install
npm run dev

Go to http://localhost:3000 and navigate trough the app. To see the custom error page: http://localhost:3000/404