Measured entry
shadcn-breadcrumb
A composable React breadcrumb built from semantic navigation, list, link, current-page, separator, and ellipsis parts. It ships as copy-in TypeScript and JSX, styled with Tailwind utility classes and theme tokens. It uses Radix Slot for custom link elements, Lucide icons, and a cn helper backed by clsx and tailwind-merge.



Measured
Every value below was written by the harness on the run that produced the frames above. None of it is derived from the prose.
| Build | OK |
|---|---|
| Mount | OK |
| Console errors | 0 |
| Uncaught page errors | 0 |
| Horizontal overflow | clean at 375, 768, 1440 |
| Axe critical | 0 |
| Axe serious | 0 |
| Axe moderate | 0 |
| Axe minor | 0 |
| Gzip marginal | 31.7 KB (97.2 KB build, 65.5 KB baseline) |
| Bare mode | FAIL |
| Provider required | NO |
| Demo used | written from the component source API |
What the harness recorded
BARE BUILD
✗ Build failed in 1.34s error during build: [vite]: Rollup failed to resolve import "lucide-react" from "<sandbox>re-ffef5a10ffd5/src/cut/components/ui/breadcrumb.tsx".
Verdict
A dependable copy-in breadcrumb for shadcn-aligned React projects. It built and mounted cleanly, stayed usable across the checked layouts, and exposed no accessibility findings. Choose it for composable markup, not for automatic route discovery or overflow behavior.
Use it if
- You want explicit control over each breadcrumb segment and its destination.
- Your app already uses Tailwind theme tokens and shadcn-style copy-in components.
- Your router needs links rendered through a custom component via the asChild pattern.
- You need semantic breadcrumb markup with customizable separators and an ellipsis part.
Skip it if
- You need the breadcrumb trail generated automatically from router state or page metadata.
- You need responsive collapsing, truncation, or an interactive overflow menu out of the box.
- Your project does not use Tailwind utilities and you do not want to translate its theme-token classes.
- You want to avoid taking dependencies on Radix Slot and Lucide icons for a small navigation pattern.
Install
| Declared dependencies | radix-ui, clsx, tailwind-merge |
|---|---|
| Missing on install | none |
| Bare install | fails once the shadcn-style helpers are removed, so it needs that setup |
| Provider | no provider required in the harness |
In a non-shadcn project, add Tailwind CSS with foreground and muted color tokens, Radix UI, Lucide React, clsx, and tailwind-merge. Provide the cn class-merging helper, configure the source alias or replace that import, then copy the component into your codebase.
Source and credit
This page is a review, not a copy. The component source lives with its author and this site does not republish it. Read the license before you use anything.
Author repository
github.com/shadcn-ui/uiAlternatives
Other published entries for the breadcrumb pattern, ordered by what they measured: mounts first, then clean axe scans, then bare-mode passes, then the smaller bundle.
- neobrutalism-breadcrumbbrutalism
- Renders
- YES
- A11y
- 0
- Gzip
- 31.8KB
- Bare
- fail
- Prov
- NO
- 8bitcn-breadcrumbskeuomorphism
- Renders
- YES
- A11y
- 0
- Gzip
- 32.5KB
- Bare
- fail
- Prov
- NO