DocumentationNavigation

Documentation / Architecture

Navigation

Sidebar data, section grouping, child menus, active state, and search links.

Architecture8 min

Data source

The sidebar is defined in lib/navigation.ts.

Navigation items can define label, href, icon, disabled, ignoreActive, targetBlank, and children.

Adding a new menu

Add a NavItem object.

Add the icon key to NavIcon.

Map the icon key in components/app-shell.tsx.

Place the NavItem inside the correct navigationSections group.

  • Use absolute application hrefs.
  • Use targetBlank only for standalone pages that should open outside AppShell.
  • Set ignoreActive for menu examples that should not mark real pages active.

Related

Other topics in the Architecture category.

ArchitectureProject Structure

The folder layout and the responsibility of each top-level area.

8 minArchitectureRouting

How static routes, dynamic routes, redirects, and 404 behavior are organized.

7 minArchitectureLayout

Global layout, dashboard layout, AppShell, and standalone page layout responsibilities.

8 min