Install the package, load its styles and components, and build your first page.
The content guide, CSS utilities, tokens, and the principles behind every pattern.
Every pattern with a live example, when to use it, and where it's already in use.
Show where you are at Penn Libraries relative to the current page, so people can tell where they are and decide where to go.
Use a breadcrumb to show where people are on our websites. It shows where you are at a glance and lets people go back up to any level without opening the menu.
Start with Penn Libraries. The first crumb always reads "Penn Libraries" and links to the Penn Libraries website. That's what turns our separate sites into one place: from any page, people can tell they're inside the Libraries and get back to the front door. The rest of the trail is the wayfinding: each crumb is a landmark on the way to the current page, and a link back to it.
Name the current page last, without a link. Mark it with aria-current="page". It signals the end of the trail and tells assistive technology which crumb is the page you're on.
Match the headings. Each crumb uses the same words as the heading of the page it leads to, so the trail reads like the site's own outline. That match also confirms the link took you where you expected, so you can trust where you are. When a heading is long, use a shorter crumb that keeps its key words, so the trail stays scannable.
Keep long titles short. A record or item title can run to a full sentence. Wrap it in pl-line-clamp so the trail stays on one line.
Set it in a band. Place the trail directly under the header in a full-width band with pl-bg-subtle, so it reads as part of the page's frame rather than its content.
This trail sits under the header and leads to a page one level below a landing page.
<pennlibs-header></pennlibs-header>
<div class="pl-reset pl-typeset">
<nav aria-label="Breadcrumb" class="pl-bg-subtle">
<div class="pl-viewport-margins">
<ol class="pl-breadcrumb">
<li class="pl-crumb"><a href="https://www.library.upenn.edu/">Penn Libraries</a></li>
<li class="pl-crumb"><a href="/">Landing page</a></li>
<li class="pl-crumb" aria-current="page">Heading level 1</li>
</ol>
</div>
</nav>
<div class="pl-viewport-margins pl-margin-t-2xl">
<h1>Heading level 1</h1>
</div>
</div>