A detail page header with breadcrumb, actions, status and tabs that folds on scroll.
Import it and pass your content. The props that matter most are listed next.
"use client";
import * as React from "react";
import { PageHeader } from "@/components/ui/notchset/blocks/page-header";
export function AgentHeader() {
const [tab, setTab] = React.useState("overview");
const [status, setStatus] = React.useState("live");
const [following, setFollowing] = React.useState(false);
return (
<PageHeader
breadcrumb={["ACME LABS", "AGENTS", "PLANNER"]}
title="Planner"
statuses={[
{ value: "live", label: "LIVE", tone: "live" },
{ value: "paused", label: "PAUSED", tone: "paused" },
]}
status={status}
onStatusChange={setStatus}
following={following}
followers={12}
onFollowChange={setFollowing}
primary={{ label: "NEW EVAL RUN", onAction: () => "EVAL RUN QUEUED" }}
tabs={[
{ value: "overview", label: "OVERVIEW" },
{ value: "runs", label: "RUNS", count: "31,406" },
]}
tab={tab}
onTabChange={setTab}
>
<p>Tab content</p>
</PageHeader>
);
}breadcrumb / title / description–
string[] / string / ReactNodeThe path (its last part hides when the condensed title appears), the 52px title and a line under it.
people / meta–
{ initials, name? }[] / { label, value }[]Avatars and the meta line; a person without a name is a +n chip.
statuses / status / onStatusChange–
{ value, label, description?, tone }[]The status pill and its menu; tone is live, paused or degraded.
following / followers / onFollowChange–
boolean / numberFOLLOW: the bell fills and the count rolls.
shareUrl–
stringSHARE copies it and shows LINK COPIED.
actions–
{ id, label, shortcut?, tone?, onSelect? }[]The ⋯ menu; return a string to confirm in the toast.
primary–
{ label, onAction }The ink button; ⌘↵ runs it from anywhere in the block.
tabs / tab / onTabChange–
{ value, label, count? }[]Tabs with counts; the underline stretches between them.
children–
ReactNodeThe selected tab's content; it scrolls under the header.
PageHeaderdata-slot="page-header"
The header and the scrolling tab content under it.
components/ui/notchset/blocks/page-header.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
pnpm dlx shadcn@latest add @beautiful-ui-pro/page-headerNeeds your registry key. Your components.json style picks the Base UI or Radix build: radix-*, new-york and default get Radix, base-* gets Base UI.
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Give your coding assistant the Markdown guide instead of screenshots.
https://beautiful-ui.dev/api/mcp (setup)v1.0.0 · 2026-10-03
First release
Pro is in early access.