Skip to content
Primer Design System
Primer Design System
Brand
About
Site navigation
Guides
Introduction
Figma
Introduction
Getting started
How to contribute
Rails
Getting started
Migration guides
React
Getting started
Theming
Theme reference
Linting
System props
Core concepts
Philosophy
Overriding styles
Hooks
Component lifecycle
Component status
Accessibility
Accessibility at GitHub
Guidelines
Tools
Alternative text for images
Assistive technology announcements
Descriptive buttons
Focus management
Headings
Links
Semantic HTML
Text resize and respacing
Tooltips
Contribute
How to contribute
Design
Documentation
Handling new patterns
Adding new components
Foundations
Color
Overview
Base scales
Accessibility
Primitives
Getting started
Token names
Color
Size
Typography
Migrating
Responsive
CSS utilities
Getting started
Animations
Borders
Box shadow
Colors
Details
Flexbox
Grid
Layout
Margin
Padding
Typography
Layout
Typography
Icons and visuals
Octicons
Octovisuals
Design guidelines
Content
UI patterns
Data visualization
Degraded experiences
Empty states
Feature onboarding
Forms
Loading
Messaging
Navigation
Progressive disclosure
Saving
Components
Action bar
Action list
Action menu
Anchored overlay
Autocomplete
Avatar
Avatar pair
Avatar stack
Blankslate
Border box
Box
Branch name
Breadcrumbs
Button
Button group
Checkbox
Checkbox group
Circle badge
Circle octicon
Clipboard copy
Close button
Comment box
Counter label
Data table
Details
Dialog
Flash
Form control
Header
Heading
Hidden text expander
Icon
Icon button
Image
Image crop
Label
Label group
Layout
Link
Markdown
Nav list
Octicon symbols
Overlay
Pagehead
Page header
Page layout
Pagination
Popover
Pointer box
Progress bar
Radio
Radio group
Relative time
Segmented control
Select
Select panel
Spinner
Split page layout
Stack
State label
Subnav
Tab container
Tab nav
Tab panels
Text
Text input
Text input with tokens
Textarea
Timeline
Toast
Toggle switch
Token
Tooltip
Tree view
Truncate
Underline nav
Underline panels
Deprecated components
Box overlay
Dropdown
Filter list
Filtered search
Menu
Select menu
Side nav
GitHub staff
GitHub shared components
Native
CLI
Getting started
Foundations
Components
Desktop
Getting started
Foundations
Mobile
Foundations
Platforms
GitHub
Desktop
These guidelines are a collection of principles, foundations and usage guidelines for designing GitHub Desktop.
Foundations
Getting started