PABCD Initiative Documentation Hub pabcd_initiative codexclaw cli-jaw

responsive-nav

Source: dev-uiux-design/references/responsive-nav.md

14. Responsive Strategy

Canonical Breakpoint Tiers

See dev-frontend/references/core/responsive-viewport.md for the canonical T1–T5+ breakpoint table, page containment rules, container query patterns, and split-screen guidance. All responsive references share that single source of truth.

Mobile-First vs Desktop-First

Choose Mobile-First WhenChoose Desktop-First When
Consumer / public-facing productInternal tool / admin panel
Content consumption primary useData-dense productivity tool
New project (progressive enhancement)Existing desktop app adding mobile

Container Queries & Split-Screen

See dev-frontend/references/core/responsive-viewport.md for canonical container query examples, @container vs @media decision guide, and split-screen/half-window rules. Nav-specific guidance below.

For navigation components, prefer @container so the same nav adapts in a sidebar, modal, or full-width header without viewport-dependent media queries.

Responsive Navigation by Density Profile

DensityDesktop NavigationMobile Navigation
D1–D3 (campaign/consumer)Horizontal top navHamburger menu
D4–D6 (SaaS/productivity)Collapsible sidebar (256px→64px)Bottom tab bar (4–5 items)
D7–D8 (ops/developer)Fixed sidebar + top breadcrumbSidebar stays, no collapse

---

15. Navigation & Information Architecture

  • Expanded: 256px fixed width. Collapsed: 64px (icons only).
  • Item height: 36px. Horizontal padding: 12px.
  • Active state: 8% primary color background + 3px left accent border.
  • Transition: 200ms ease-in-out.
  • Group sections with subtle separators and 10px uppercase section labels.

Tab Bar (Bottom Navigation — Mobile)

  • Maximum 5 items. Active item has filled icon + label. Inactive: outline icon only.
  • Safe area padding for notch/home-indicator devices.
  • Center the primary action if it has elevated importance (FAB pattern).

Command Palette (Cmd+K)

  • Centered modal at 20% from top, max-width 600px.
  • Instant search with fuzzy matching.
  • Category grouping (Actions, Pages, Settings).
  • Recent items shown on empty query.
  • Keyboard navigation: arrow keys + Enter.
  • Use for hierarchical navigation deeper than 2 levels.
  • Show abbreviated path on mobile (... > Parent > Current).
  • Clickable segments except the current page.
  • Separator: / or > — pick one and be consistent.

By Product Surface

SurfacePrimary NavSecondary NavSearch
Landing/marketingHorizontal top navFooter linksNot needed
Consumer appBottom tab bar (mobile), sidebar (desktop)In-context navigationOptional
SaaS/productivityCollapsible sidebarBreadcrumbs + tabsCommand palette
Dashboard/opsFixed sidebarTab groups per sectionAlways visible search bar
Developer toolSidebar + command paletteBreadcrumbsProminent Cmd+K