Skip to content

Navigation

NuxtBase uses different navigation shells for different parts of the product.

If you edit the wrong file, you will only change one area and assume the rest is broken.

The public header and footer live in:

app/layouts/default.vue

This layout controls:

  • top-level marketing nav links
  • login/register/dashboard actions
  • mobile menu structure
  • footer brand and footer link areas

If you want to change homepage, blog, docs, or auth-entry navigation, start here.

The docs shell lives in:

app/layouts/docs.vue

This layout controls:

  • docs header links
  • docs search button
  • content navigation sidebar
  • mobile docs slideover

The actual docs tree comes from Nuxt Content navigation data, so docs navigation is a mix of layout structure and content structure.

Authenticated app navigation lives in:

app/layouts/dashboard.vue

The current sidebar is assembled from two groups:

  • organization items
  • account items

Those arrays are a cleaner customization point than editing random buttons in feature pages.

Some links are intentionally role-aware:

  • the admin shortcut only appears for platform_admin
  • organization pages assume an active organization
  • some feature actions are visible only to managers

So when you add or remove nav items, make sure the target route still matches your access rules.