mydot/agents/.agents/skills/nuxt-ui/references/recipes/navigation.md

Navigation

Patterns for headers, sidebars, breadcrumbs, and tab navigation.

Header with mobile menu

UHeader default slot is desktop nav, #body is the mobile menu. Without #body, mobile users have no navigation.

<UHeader>
  <template #title>
    <Logo class="h-6 w-auto" />
  </template>

  <UNavigationMenu :items="items" />

  <template #right>
    <UColorModeButton />
    <UButton label="Sign in" color="neutral" variant="ghost" />
  </template>

  <template #body>
    <UNavigationMenu :items="items" orientation="vertical" class="-mx-2.5" />
  </template>
</UHeader>

Full app shell example in landing layout.

Sidebar navigation (dashboard)

See dashboard layout for the full sidebar pattern with UDashboardSidebar + UNavigationMenu. Key points:

• Pass :collapsed="collapsed" to UNavigationMenu inside collapsible sidebars
• Use NavigationMenuItem[][] (nested arrays) for separate nav groups
• Use #footer slot for user menu with UDropdownMenu

Breadcrumbs

<script setup lang="ts">
const route = useRoute()

const breadcrumbs = computed(() => {
  const segments = route.path.split('/').filter(Boolean)
  return segments.map((segment, index) => ({
    label: segment.charAt(0).toUpperCase() + segment.slice(1),
    to: '/' + segments.slice(0, index + 1).join('/')
  }))
})
</script>

<template>
  <UBreadcrumb :items="breadcrumbs" />
</template>

Tab navigation (within a page)

<script setup lang="ts">
const items = [{
  label: 'Overview',
  icon: 'i-lucide-layout-dashboard',
  slot: 'overview' as const
}, {
  label: 'Activity',
  icon: 'i-lucide-activity',
  slot: 'activity' as const
}, {
  label: 'Members',
  icon: 'i-lucide-users',
  slot: 'members' as const
}]
</script>

<template>
  <UTabs :items="items">
    <template #overview>
      <!-- Overview content -->
    </template>
    <template #activity>
      <!-- Activity feed -->
    </template>
    <template #members>
      <!-- Members list -->
    </template>
  </UTabs>
</template>