UI Patterns

Design guidelines covering common user workflows.

placeholder, blank area with an gray background color

Data visualization

Data visualizations are helpful tools for conveying complex data in an engaging and understandable way. They're commonly used in dashboards and insights pages.

Learn more
placeholder, blank area with an gray background color

Degraded experiences

Ensuring that a page still renders and primary experiences are still available during downtime of optional service dependencies.

Learn more
placeholder, blank area with an gray background color

Empty states

Empty states are used to fill spaces when no content has been added yet, or is temporarily empty due to the nature of the feature.

Learn more
placeholder, blank area with an gray background color

Feature onboarding

Onboarding is a virtual unboxing experience that helps users get started with a feature. This is a guide for designing onboarding for the product and does not include what to do for marketing pages, email announcements, social media, etc.

Learn more
placeholder, blank area with an gray background color

Forms

Primer's form design guidelines aim to minimize the effort and cognitive load required to complete a task that requires data input from the user. For example, creating a new repo configuring settings, and logging in.

Learn more
placeholder, blank area with an gray background color

Loading

How to use loading states to help users stay informed and engaged while waiting.

Learn more
placeholder, blank area with an gray background color

Navigation

Navigation patterns help users understand where they are and where they can go next.

Learn more
placeholder, blank area with an gray background color

Notification messaging

Messaging components are used to provide important and relevant information to the user, including feedback, contextual information, product updates, and more.

Learn more
placeholder, blank area with an gray background color

Progressive disclosure

Progressive disclosures are a design pattern that hides and shows information based on user interaction. They should be used sparingly, only when it's necessary to truncate information.

Learn more
placeholder, blank area with an gray background color

Saving

Save patterns help users store and update their content and configuration throughout GitHub. These changes should be represented in the UI accurately, quickly, and obviously. Their behavior should inspire confidence and trust.

Learn more