Foundations

Foundations are the building blocks of our design system and include defined grids, breakpoints, spacing, patterns, iconography, and placeholders. These elements create consistency for the user and deliver an experience that is usable, accessible, and aligned to the brand.

Standard scope

This standard applies to:

  • pennmedicine.org
  • All Penn Medicine websites
  • Penn Medicine mobile applications
  • All Penn Medicine digital products

Overview

Foundations are typically used to:

  • Create new digital experiences: Apply foundations when building new pages, features, or applications to ensure consistency from the start.
  • Update or redesign existing interfaces: Use foundations to evaluate current layouts, patterns, and behaviors against our latest standards.
  • Scale experiences across platforms: Whether designing for mobile, tablet, or desktop, foundations help maintain a unified look and feel.
  • Support accessibility and usability: Foundations ensure that designs are clear, consistent, and accessible to all users, including patients, families, and staff members.

Use cases

Each foundational element serves a specific purpose and should be used consistently across the digital ecosystem.

Foundation type
Design System name
When to use
Grids and breakpoints
Mobile
Tablet
Desktop Small
Desktop Standard
Desktop Large

Desktop Full grid 12 columns
Desktop 8 Columns to the right
Desktop 8 Columns to the center
Used to create consistent layouts that adapt to different screen sizes.
Spacing
Always. The spacing system maintains a digital experience that feels professional, easy to navigate, and trustworthy.
Patterns
Pattern
Squares Pattern
Used when unobtrusive texture helps users to delineate content.
Iconography
Interface Icons
Medical Icons
Used to help communicate functionality, capabilities or other useful information to a user through a graphic, instead of words.
Placeholders and loading
Image
Use empty state placeholders if content isn't available or if something isn’t loading correctly. Placeholders reduce confusion and help users continue their journeys to ensure a seamless user experience in imperfect circumstances.

Grids and breakpoints

Grids and breakpoints help designers create consistent layouts that adapt to different screen sizes.

Grid breakpoints that are supported are:

Mobile - 4 column

Tablet - 8 column

Desktop - 12 column

Desktop Large - 12 column

Desktop scalability

Desktop Full Grid 12 Columns

Desktop 8 Columns to the Right

Desktop 8 Columns to the Center

Spacing

Spacing systems are a set of rules around how to place elements within layout or components. Our scale is an 8pt linear scale for elements.

Patterns

Patterns add visual interest and enhance the user experience.

Pattern

This pattern is made up of Penn Medicine shields.

The multi-shield pattern on a white background.

The multi-shield pattern on a navy background.

The full variation.

The corner desktop variation.

The corner variation for mobile/tablet.

Square Pattern

This pattern is not repeated and is made up of 4 colors.

Iconography

Our iconography library includes a comprehensive set of  lightweight vector graphics.

Empty State placeholders and loading

Photo empty states

Some components require a photo to be selected by the content author. If one isn’t selected, there will be a placeholder.

Provider/individual placeholders

Provider/individual placeholders contain the initials of the individual as plain text.

Provider header.

Provider thumbnail.

Location placeholders

Location placeholders can be a standard image or graphic.

Facility location.

Penn location thumbnail.

Penn location hero.

Loading media

When media isn't available, the media arrow icon will remain, overlayed, until the media is available.

Behavior

Interactive

  • Grids can be changed by resizing the browser to different breakpoints.
  • Icons can be clicked when used as in button or link.

Non-interactive

  • Patterns are intended to balance the visual design.
  • Spacing is constant and isn’t interactive.
  • Icons are occasionally used to enrich information and may not be clickable.
  • Location placeholders: An icon or shield will display on locations whenever an image is not selected.
  • Provider placeholders: An individual's initials display whenever an image is not provided.

Customizable  elements

Grid & Breakpoints

Element
Required/Optional
Guidelines
Specs
Mobile
Required
Breakpoints: 0-479px
Columns: 4
Margins: 24px
Gutter: 16px
Tablet
Required
Breakpoints: 480-1023px
Columns: 8
Margins: 48px
Gutter: 24px
Desktop
Required
Breakpoints: 1024-1920px
Columns: 12
Margins: 108px
Gutter: 24px
Desktop Large
Required
The grid stays static in the middle, and the margins will be fluid.
Breakpoints:1921-♾️px
Columns: 12
Margins: Fluid
Gutter: 24px
Desktop Full Grid 12 Columns
Optional
This is used on homepage and landing pages.
12 full columns
Desktop 8 Columns to the Right
Optional
This is used on pages that contain a side navigation.
8 columns right
4 columns left
Desktop 8 Columns to the Center
Optional
This is used on text heavy pages such as condition details and other detail pages.
8 columns center
2 columns left
2 columns right

Patterns

Element
Required/Optional
Guidelines
Specs
Pattern
Optional
It can be used on light and dark backgrounds and positioned in the center or corner.

Placeholders

Element
Required/Optional
Guidelines
Specs
Image
Required
Empty state placeholders are displayed when images are missing. They help users continue on their journeys to gather information and complete tasks, even if something isn’t loading correctly. They reduce confusion and ensure a seamless user experience in imperfect circumstances.
Displayed as an individual's initial.
Displayed as a standard image or graphic when other information is not available.
Loader
Optional
There is the option to use gradient animations and gradient to photo transitions for loading.

Guidelines (do’s and don’ts)

Do
  • Do crop the container to the part of the pattern you want to show.
  • Do use the full variant of the multi-shield pattern as a background visual to balance a screen.
  • Do consistently use the grid and breakpoints defined
  • Do use icons from the approved system to maintain visual consistency
Don't
  • Don’t misuse the Penn Medicine shield and wordmark on empty states. Refer to the shield and logo standardsto ensure alignment with the Penn Medicine brand.
  • Don’t apply arbitrary margins or padding that break the grid alignment.
  • Don’t reduce or expand the size of the patterns.
  • Don’t change the orientation of the pattern.
  • Don’t insert custom spacing values that aren’t part of the design system.
  • Don’t use anything other than 8px spacing
  • Don’t create custom icons without approval

Related resources

For designers: Visit the Designers section for access to component specs and Figma files.

For developers: Visit the Developers section for implementation details and to access the front-end code library in Storybook.

Contact

For more information about this standard, email: web-standards@pennmedicine.upenn.edu

Last updated

Date
Version
Description
05/01/2025
1.0.0
Initial Release