Breadcrumb
Freev1.0.0A path that folds its middle levels into a … menu and truncates long names with a tooltip.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { BreadcrumbTrail } from "@/components/ui/notchset/breadcrumb";
export function AppBar() {
return (
<BreadcrumbTrail
items={[
{ label: "Acme Labs", href: "/" },
{ label: "Atlas", href: "/atlas" },
{ label: "Planner", href: "/atlas/planner" },
{ label: "run_8F3A1" },
]}
/>
);
}Props
items (BreadcrumbTrail)–{ label, href?, type? }[]The path, root first; the last is the current page.
onNavigate (BreadcrumbTrail)–(item, event) => voidCalled when a level is picked; preventDefault() to route on the client.
maxCrumbWidth (BreadcrumbTrail)–numberWhere long names truncate (200px).
Anatomy
- Same parts as shadcn's Breadcrumb, plus BreadcrumbTrail.
- The fold menu is the Dropdown Menu; long names use the Tooltip.
- The demo routes on the client through onNavigate and adds ↑ PARENT.
BreadcrumbTraildata-slot="breadcrumb"The whole path from data, with folding.
Breadcrumb / BreadcrumbList / BreadcrumbItemdata-slot="breadcrumb-list"shadcn's parts, to compose by hand.
BreadcrumbLink / BreadcrumbPagedata-slot="breadcrumb-link"A level, or the current page.
BreadcrumbSeparator / BreadcrumbEllipsisdata-slot="breadcrumb-separator"The slash, and the … mark.
Source
components/ui/notchset/breadcrumb.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/breadcrumb.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/breadcrumb.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. No extra packages: React and Tailwind CSS v4 are enough.
- 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/breadcrumb.tsx
- lib/beautiful-ui/notchset/breadcrumb.tsx
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), Dropdown Menu, Tooltip, the theme foundation (its tokens and base styles)
Styles didn't apply?
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.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Deep hierarchies (workspace, project, agent, run)
- An app bar that shows where you are
Use something else when
- Flat sites with one or two levels
- Steps in a flow: use Stepper
Mistakes to avoid
- Don't make the current page a link
- Keep labels short; the full name lives in the tooltip
Agents find it by
- breadcrumb, path, navigation trail, hierarchy, app bar, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/breadcrumb.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- Enter / Space
- Open the … menu; arrows move through hidden levels
Accessibility
- nav labelled Breadcrumb with an ordered list
- The current page has aria-current=page and is not a link
- The fold button says how many levels it hides; separators are hidden from screen readers
Motion
- … menu
- Drops in like every Notchset menu
Responsive
- Folds as the bar narrows; never wraps.
Performance
- Measures once per resize from an invisible copy of the path.
Changelog
v1.0.0 · 2026-10-04
First release
