GitHub Primer

primer.style

Free plan Open source WebAPI

Spec score 8.3 #4 of 26 in UI Kit Libraries

What it is

GitHub Primer is a free, open-source design system for designing and building GitHub interfaces. Its guidance covers product UI components, patterns, and design tokens for color, spacing, and typography. Primer Brand addresses marketing websites and other digital experiences. React documentation explains theming, recommended practices, and component extension. Primer also provides accessibility guidance and tools, along with Octicons, GitHub’s scalable icon set. Product UI documentation includes an MCP server page. Component status is identified as experimental, ready, or deprecated; ready components are described as mature with long-term support expected. Primer Web and Primer Primitives are available through the Primer Figma Community page, while GitHub’s Figma organization is limited to GitHub team members. The Primer Mobile Figma library is internal only. GitHub employees alone can contribute to Primer Web because of Figma’s open-source file handling. GitHub’s Design Infrastructure and Design Engineering teams maintain the CSS framework, documentation, tools, libraries, and component libraries.

Spec sheet

What it does: Primer is GitHub’s design system for its interfaces.Read 14 Oct 2026 · primer.style
Product: Primer is GitHub’s design system, with guidelines, principles, and patterns for designing and building UI at GitHub.Read 9 Oct 2026 · primer.style
Support: The Figma libraries page directs questions to GitHub’s #primer-figma Slack channel or the github/primer repository issue tracker.Read 9 Oct 2026 · primer.style
Accessibility: Primer includes accessibility foundations, policies, principles and frameworks for accessible experiences.Read 14 Oct 2026 · primer.style
Brand release: The Primer Brand site lists version 0.79.0 as its latest release.Read 14 Oct 2026 · primer.style
Brand UI: Primer Brand UI is GitHub’s system for marketing websites and digital experiences.Read 14 Oct 2026 · primer.style
Component lifecycle: Primer marks components as experimental, ready, or deprecated, and says ready components are mature with long-term support expected.Read 9 Oct 2026 · primer.style
Components: The Product UI documentation catalogs dozens of components including buttons, dialogs, forms, navigation, tables and overlays.Read 14 Oct 2026 · primer.style
Contribution limits: Only GitHub employees can contribute to Primer Web because of how Figma handles open source files.Read 9 Oct 2026 · primer.style
Contributions: Primer publishes contribution guidance for adding components, documentation, Figma work and other changes.Read 14 Oct 2026 · primer.style
CSS changelog: The Primer CSS repository lists v22.3.0 as its latest release and describes a class-name export and pagination selector changes.Read 14 Oct 2026 · github.com
CSS utilities: Primer documents CSS utilities for animation, borders, box shadows, flexbox, grid, layout, spacing and typography.Read 14 Oct 2026 · primer.style
Design tokens: Primer Primitives provide design tokens for color, spacing and typography.Read 14 Oct 2026 · primer.style
Figma: Primer Web and Primer Primitives are available through the Primer Figma Community page, while access to GitHub’s Figma organization is limited to GitHub team members.Read 9 Oct 2026 · primer.style
Icons: Octicons is a scalable set of icons handcrafted by GitHub.Read 9 Oct 2026 · primer.style
Independent adoption: OpenProject says it began adopting Primer in 2023 and planned to use it for new features while gradually revising existing ones.Read 14 Oct 2026 · openproject.org
Independent feature use: OpenProject 17.2 updated its Backlogs module and several administration interfaces with Primer components.Read 14 Oct 2026 · openproject.org
Independent limit: gradual migration: OpenProject reports that its existing interface is being migrated to Primer gradually rather than all at once.Read 14 Oct 2026 · openproject.org
Independent limit: unresolved accessibility issues: The 2026 Primer Docs conformance report records several WCAG 2.2 AA criteria as only partially supported, with low-priority exceptions.Read 14 Oct 2026 · accessibility.github.com
Independent roadmap: OpenProject’s design-system roadmap includes Primer work for page headers, popovers, tables, color-blind mode, account screens and accessibility improvements.Read 14 Oct 2026 · community.openproject.org
Licence: The Primer design repository is released under the MIT license.Read 14 Oct 2026 · github.com
Limit: accessibility context still required: GitHub’s Primer annotation guidance says accessible components alone do not guarantee correct heading hierarchy, focus order, reflow or other page-level outcomes.Read 14 Oct 2026 · github.com
Limit: component complexity: GitHub says design systems with more than 60 components can make annotation prioritization difficult and that mapping properties can take substantial time.Read 14 Oct 2026 · github.blog
Limit: maintenance overhead: GitHub’s annotation article warns that mature Primer components change frequently and annotations can fall out of sync without monitoring, creating confusion and rework.Read 14 Oct 2026 · github.blog
Maker investors: Crunchbase lists seven GitHub investors, including Sequoia Capital and Andreessen Horowitz.Read 14 Oct 2026 · crunchbase.com
Maker ownership: Crunchbase records GitHub as acquired by Microsoft and lists GitHub’s headquarters in San Francisco, California.Read 14 Oct 2026 · crunchbase.com
Maker team: GitHub’s Design Infrastructure and Design Engineering teams build and maintain Primer, including its CSS framework, documentation, Octicons, tools, libraries, and component libraries.Read 9 Oct 2026 · primer.style
MCP: The Product UI documentation includes an MCP server page.Read 9 Oct 2026 · primer.style
Mobile design: The Primer Mobile Figma library is listed as internal only.Read 9 Oct 2026 · primer.style
Octicons: Octicons are GitHub’s scalable SVG icon set and are presented as a shared Primer foundation.Read 14 Oct 2026 · primer.style
Open-source documentation: Primer’s design repository describes itself as documentation for components, UI patterns, foundations, guides and more.Read 14 Oct 2026 · github.com
Patterns: Primer documents common workflow patterns such as create, edit, delete, search, filter and view.Read 14 Oct 2026 · primer.style
Praise: accessible foundation: OpenProject describes Primer as having accessibility requirements at its core and says its adoption supports a more intuitive interface.Read 14 Oct 2026 · openproject.org
Praise: consistency and accessibility: OpenProject says it selected Primer to improve consistency, responsiveness, reusability, accessibility and perceived quality.Read 14 Oct 2026 · openproject.org
Product UI: Primer Product UI supplies guidelines, principles and patterns for designing and building GitHub user interfaces.Read 14 Oct 2026 · primer.style
Rails support: Primer’s Product UI navigation includes Rails guidance, migration guides and a component list.Read 14 Oct 2026 · primer.style
React: Primer provides React component documentation and related guidance for theming, recommended practices, and extending components.Read 9 Oct 2026 · primer.style
React documentation: The React documentation covers getting started, components, themes, principles, contribution, testing and troubleshooting.Read 14 Oct 2026 · github.com
React hooks: Primer React documents hooks for focus management, overlays, themes, responsive values and related interaction behavior.Read 14 Oct 2026 · primer.style
React installation: Primer React can be installed with npm using `npm install @primer/react` or with Yarn.Read 14 Oct 2026 · github.com
React library: The public Primer React repository implements the design system as React components.Read 14 Oct 2026 · github.com
React licence: The Primer React repository is marked as MIT licensed.Read 14 Oct 2026 · github.com
Security and accessibility testing: Primer Docs’ conformance assessment used keyboard-only testing, JAWS, NVDA with Chrome, axe, a color-contrast analyzer and zoom/high-contrast features.Read 14 Oct 2026 · accessibility.github.com

Plans and prices

Primer Free Design system for GitHub; no paid plans listed Read 9 Oct 2026 · primer.style

Every GitHub Primer plan and price →

Strong points and limits

Strong points

Free and open source
Documents components, patterns, and design tokens
Includes React guidance and theming documentation
Provides accessibility resources and tools
Offers Octicons and Figma resources

Limits

Primer Mobile Figma library is internal only
GitHub Figma organization access is restricted
Only GitHub employees can contribute to Primer Web
Some components are experimental or deprecated

Who it suits

Primer suits teams building web interfaces who want GitHub’s documented components, tokens, React guidance, accessibility resources, and Figma assets. It is listed for web and API use.

Verdict

Primer provides a broad, documented system for GitHub-style product and brand interfaces. Figma access and contribution restrictions should be considered when planning design workflows.

Where Specifiction places it

UI Kit Libraries#4 of 268.3

Alternatives to GitHub PrimerAll alternatives →

Figma Wireframe Kit From $3/mo · Free plan 9.2 Visit

Ant Design Icons Free plan 8.7 Visit

Carbon Design System Free plan 8.4 Visit

Shopify From $29/mo 8.2 Visit

Flowbite Figma Design System Free plan 8.0 Visit

Singapore Government Design System Free plan 8.0 Visit

Adobe Spectrum 7.9 Visit

GOV.UK Design System Free plan 7.9 Visit