ui

Breadcrumb

Displays the path to the current resource using a hierarchy of links. Built with Base UI and Tailwind CSS. Copy-paste ready.

Installation

Usage

Examples

With custom separator

Replaces the default / separator with a custom icon such as ChevronRight for a more modern navigation style.

With Dropdown Menu

Collapses intermediate path segments into a Menu dropdown triggered by the BreadcrumbEllipsis for long paths.

Replaces the anchor elements with next/link for client-side navigation in Next.js applications.

With Icons

Prepends an icon to each breadcrumb link to visually indicate the resource type (file, folder, home).

With Avatar

Replaces the last breadcrumb item with an Avatar to represent the current user or profile page.

Inside Card

Renders the breadcrumb inside a Card header to provide navigation context for detail or settings views.

With Home Icon

Uses a house icon in place of the text "Home" for the first item to reduce visual weight on space-constrained headers.

Button-style

Renders each breadcrumb item as a pill-shaped button for a more interactive, tab-like navigational appearance.

With Project and User Info

A rich breadcrumb including avatar, project name, and document labels, suited for collaborative app page headers.

File Path

Renders a filesystem path using folder and file icons in monospace font with a / separator, ideal for code editors or file explorers.

Checkout Steps

A multi-step progress breadcrumb with numbered circles and check icons for completed steps, plus Back and Continue navigation buttons.

Admin Hierarchy

An organization → team → member breadcrumb where each level has a distinct colored icon badge (violet, blue, emerald) to indicate resource type.

A breadcrumb integrated into a page header with right-aligned edit and share action buttons, separated from the nav path by a vertical divider.

Compact With Ellipsis

Collapses long paths into a BreadcrumbEllipsis trigger with a badge showing the count of hidden items in a dropdown menu.