v1.8.0
    • Get started

      Install the package, load its styles and components, and build your first page.

    • Foundations

      The content guide, CSS utilities, tokens, and the principles behind every pattern.

    • Patterns

      Every pattern with a live example, when to use it, and where it's already in use.

    Page Layout

    Start from a recommended page layout, so every page on our websites has a consistent layout and the heading is always where people expect it.

    When to use

    Use these layouts as the starting point for the pages on our websites. Most websites need three kinds of page: a landing page, section landing pages, and detail pages. When every website builds them the same way, people know where to find the header, the way back, the heading, and the content, no matter which of our websites they're on.

    How to use

    Start and end every page the same way. Start with the header and end with the footer. Everything else goes between them.

    Put the h1 in the same place every time. It comes directly after the header, or after the breadcrumb when there is one, and lines up with the left edge of the header. It's the first thing in the content, so people always know where to find the name of the page they're on.

    Follow the h1 with a lede. One or two sentences that tell people what they can do here.

    Line content up with the header. Wrap each band of content in pl-viewport-margins so its edges match the header and footer at every screen size.

    Use the same words throughout. The h1, the last crumb, and the page title all name the page the same way.

    Landing page

    The landing page is the front door of a website and a place to start. A hero welcomes people to the website and sparks their interest in what they can do here. It holds the header, the h1, and a sub heading. Below it, sections set people up to dig deeper, each with a heading, a lede, and cards that lead into the website. Alternate the section backgrounds to separate them. Digital Collections and Philadelphia Area Archives use this layout.

    <div class="pl-reset pl-typeset">
      <pennlibs-hero>
        <picture hero="art-direction">
          <img src="https://iiif-images.library.upenn.edu/iiif/3/6c59afac-7ab4-47f4-8780-b7ac511b8679/pct:13,13,78.5,24/1440,/0/default.jpg" alt="" />
        </picture>
        <pennlibs-header service-name="Service name" theme="dark" slot="start"></pennlibs-header>
        <h1 hero="heading">Page level 1 heading</h1>
        <p hero="sub-heading">Sub heading paragraph</p>
      </pennlibs-hero>
      <main>
        <section class="pl-padding-y-2xl">
          <div class="pl-viewport-margins">
            <h2>Page level 2 heading</h2>
            <p class="pl-line-length pl-margin-b-xl">Section lede paragraph.</p>
            <ul class="pl-cards">
              <li class="pl-card pl-card--callout">
                <h3 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h3>
                <p class="pl-card__description">Card description</p>
              </li>
              <li class="pl-card pl-card--callout">
                <h3 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h3>
                <p class="pl-card__description">Card description</p>
              </li>
              <li class="pl-card pl-card--callout">
                <h3 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h3>
                <p class="pl-card__description">Card description</p>
              </li>
            </ul>
          </div>
        </section>
        <section class="pl-padding-y-2xl pl-bg-subtle">
          <div class="pl-viewport-margins">
            <h2>Page level 2 heading</h2>
            <p class="pl-line-length pl-margin-b-xl">Section lede paragraph.</p>
            <ul class="pl-cards">
              <li class="pl-card pl-card--callout">
                <h3 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h3>
                <p class="pl-card__description">Card description</p>
              </li>
              <li class="pl-card pl-card--callout">
                <h3 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h3>
                <p class="pl-card__description">Card description</p>
              </li>
              <li class="pl-card pl-card--callout">
                <h3 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h3>
                <p class="pl-card__description">Card description</p>
              </li>
            </ul>
          </div>
        </section>
      </main>
      <pennlibs-footer></pennlibs-footer>
    </div>
    

    Section landing page

    A section landing page introduces one part of a website and leads to the pages inside it. A subtle band under the header holds the breadcrumb, the h1, and a lede. Cards below it lead to each page in the section. The sections of this design system, like Patterns, use this layout.

    <div class="pl-reset pl-typeset">
      <pennlibs-header service-name="Service name"></pennlibs-header>
      <div class="pl-bg-subtle">
        <nav aria-label="Breadcrumb">
          <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="/">Service name</a></li>
              <li class="pl-crumb" aria-current="page">Page level 1 heading</li>
            </ol>
          </div>
        </nav>
        <div class="pl-viewport-margins pl-padding-y-2xl">
          <h1>Page level 1 heading</h1>
          <p class="pl-line-length pl-font-size-l pl-margin-b-0">Lede paragraph</p>
        </div>
      </div>
      <main class="pl-viewport-margins pl-padding-y-2xl">
        <ul class="pl-cards">
          <li class="pl-card pl-card--callout">
            <h2 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h2>
            <p class="pl-card__description">Card description</p>
          </li>
          <li class="pl-card pl-card--callout">
            <h2 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h2>
            <p class="pl-card__description">Card description</p>
          </li>
          <li class="pl-card pl-card--callout">
            <h2 class="pl-card__heading pl-h3"><a class="pl-card__link" href="#">Card heading</a></h2>
            <p class="pl-card__description">Card description</p>
          </li>
        </ul>
      </main>
      <pennlibs-footer></pennlibs-footer>
    </div>
    

    Detail page

    A detail page is about one thing, like a record, an item, or a guide. The breadcrumb sits in its own subtle band under the header, and the h1 starts the main content. Put text in pl-prose to keep it at a readable line length.

    <div class="pl-reset pl-typeset">
      <pennlibs-header service-name="Service name"></pennlibs-header>
      <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="/">Service name</a></li>
            <li class="pl-crumb"><a href="#">Section landing page heading</a></li>
            <li class="pl-crumb" aria-current="page">Page level 1 heading</li>
          </ol>
        </div>
      </nav>
      <main class="pl-viewport-margins pl-prose pl-padding-y-2xl">
        <h1>Page level 1 heading</h1>
        <p class="pl-font-size-l">Lede paragraph</p>
        <dl class="pl-dl">
          <dt>Term</dt>
          <dd>Description</dd>
          <dt>Term</dt>
          <dd><a href="#">Linked description</a></dd>
        </dl>
        <h2>Page level 2 heading</h2>
        <p>Body paragraph text.</p>
      </main>
      <pennlibs-footer></pennlibs-footer>
    </div>
    
    • Header - Starts every page with the logo, website name, and menu.
    • Hero - Holds the header and h1 on a landing page.
    • Breadcrumb - Shows where the page sits and leads back to the Penn Libraries website.
    • Card - Leads from landing pages to the pages inside them.
    • Footer - Ends every page.
    • Page title - Names the page in the browser tab.
    • Wayfinding and sense of place - People should always be able to tell where they are.

    Accessibility

    These layouts follow where accessibility standards are heading. The WCAG 3.0 draft asks for recognizable layouts that follow conventions people already know, and consistency across views, so the same things work the same way from page to page.

    Keeping the h1 in one place, with a breadcrumb under the header, supports user orientation: people can always tell where they are and how to get back. One h1 and clear headings below it give each page a structure people can move through.

    Where we use it

    Design System

    Get started Foundations Patterns Release notes · v1.8.0 Design notes