build69
build69  /  Components  /  Navigation  /  Topbar

Topbar

v1.0.10Updated 27 Aug 2026

Persistent app-level top bar with breadcrumb / page title slot, action buttons, and user menu.

Preview

Live · 12 stories
DefaultOpen ↗
Why this is recommendedheadertopbarnavbarshell+1

The default, out-of-the-box Topbar.

Recommended for+14
  • Top of every AppShell-wrapped page
Tags+6
headertopbarnavbarshelldefault
Features+4
  • Breadcrumb slot
  • Action button slot
  • User avatar + dropdown
  • Search slot (⌘K)
  • Sticky
  • i18n: labels prop overrides every built-in UI string (workspace switcher, search palette, create menu, app launcher, notifications, user menu, aria-labels); merged over DEFAULT_TOPBAR_LABELS
Not recommended for−2
  • In-page section headers (use PageHead)

Install

Ask your agent, or call the MCP tool directly. The resolved bundle is written into your project.

get_registry_item({ name: "Topbar" })

Usage

import { Topbar } from '@/components/navigation/topbar';

<Topbar title="Invoices" actions={<Button>New invoice</Button>} />

Tick variants in the left menu — each adds a tab with that variant’s real story source, the same code the preview above renders.

Props

PropTypeRequired
title

Page title

string
actions

Right-aligned actions

ReactNode
labels

Override any built-in UI string — workspace switcher, search palette, create menu, app launcher, notifications, user menu, aria-labels (i18n). Merged over DEFAULT_TOPBAR_LABELS; {count} template for the unread-bell aria-label

Partial<TopbarLabels>

Related