GitHub Primer
GitHub Primer is GitHub’s design system for creating product interfaces and digital experiences.
What GitHub Primer is
GitHub Primer is GitHub’s design system for creating product interfaces and digital experiences. Primer Product UI documents components, patterns, and design tokens for color, spacing, and typography, while Primer Brand addresses marketing websites and other digital experiences. React documentation covers components, theming, recommended practices, and extending components. Primer also provides accessibility resources, guidelines, and tools, along with Octicons, a scalable icon set handcrafted by GitHub. Components carry experimental, ready, or deprecated status; GitHub describes ready components as mature, with long-term support expected. Primer Web and Primer Primitives are available through the Primer Figma Community page, but GitHub’s Figma organization is restricted to team members. The Primer Mobile Figma library is internal only, and only GitHub employees can contribute to Primer Web because of Figma’s open-source file handling. Product UI documentation includes an MCP server page. Primer is free and open source, with no paid plans listed.
Good
- Free and open source
- React component and theming guidance
- Accessibility resources and tools included
- Octicons icon set included
Watch out
- Primer Mobile Figma library is internal only
- Only GitHub employees can contribute to Primer Web
- GitHub Figma organization access is restricted
Who it suits
Primer suits designers and developers building product interfaces or marketing experiences, particularly those seeking guidance on React, accessibility, and design tokens. Figma access and contribution restrictions may matter to teams outside GitHub.
Verdict
Primer offers a broad set of design guidance, components, accessibility resources, and icons without a listed paid plan. Review its Figma access and contribution limits if those are central to your workflow.
Plans and prices
From GitHub Primer's own pricing page, checked 9 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Primer | Free | Design system for GitHub; no paid plans listed |
The facts
Each one read from GitHub Primer's own pages, with the date it was checked.
What it does
- Accessibility
- Primer includes accessibility foundations, policies, principles and frameworks for accessible experiences.checked 14 Oct 2026
- Brand release
- The Primer Brand site lists version 0.79.0 as its latest release.checked 14 Oct 2026
- Brand UI
- Primer Brand UI is GitHub’s system for marketing websites and digital experiences.checked 14 Oct 2026
- Component lifecycle
- Primer marks components as experimental, ready, or deprecated, and says ready components are mature with long-term support expected.checked 9 Oct 2026
- Components
- The Product UI documentation catalogs dozens of components including buttons, dialogs, forms, navigation, tables and overlays.checked 14 Oct 2026
- Contribution limits
- Only GitHub employees can contribute to Primer Web because of how Figma handles open source files.checked 9 Oct 2026
- Contributions
- Primer publishes contribution guidance for adding components, documentation, Figma work and other changes.checked 14 Oct 2026
- CSS changelog
- The Primer CSS repository lists v22.3.0 as its latest release and describes a class-name export and pagination selector changes.checked 14 Oct 2026
- CSS utilities
- Primer documents CSS utilities for animation, borders, box shadows, flexbox, grid, layout, spacing and typography.checked 14 Oct 2026
- Design tokens
- Primer Primitives provide design tokens for color, spacing and typography.checked 14 Oct 2026
- 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.checked 9 Oct 2026
- Icons
- Octicons is a scalable set of icons handcrafted by GitHub.checked 9 Oct 2026
- Independent adoption
- OpenProject says it began adopting Primer in 2023 and planned to use it for new features while gradually revising existing ones.checked 14 Oct 2026
- Independent feature use
- OpenProject 16.2 applied Primer to project creation and project-copy forms to improve consistency and accessibility.checked 14 Oct 2026
- Independent limit: gradual migration
- OpenProject reports that its existing interface is being migrated to Primer gradually rather than all at once.checked 14 Oct 2026
- 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.checked 14 Oct 2026
- Independent roadmap
- OpenProject’s design-system roadmap includes Primer work for page headers, popovers, tables, color-blind mode, account screens and accessibility improvements.checked 14 Oct 2026
- Licence
- The Primer design repository is released under the MIT license.checked 14 Oct 2026
- 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.checked 14 Oct 2026
- 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.checked 14 Oct 2026
- 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.checked 14 Oct 2026
The company
- Maker investors
- Crunchbase lists seven GitHub investors, including Sequoia Capital and Andreessen Horowitz.checked 14 Oct 2026
- Maker ownership
- Crunchbase records GitHub as acquired by Microsoft and lists GitHub’s headquarters in San Francisco, California.checked 14 Oct 2026
- 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.checked 9 Oct 2026
Alternatives to GitHub Primer
- 1
Figma Wireframe Kit
Free planAndroidiOSWebAPI8.0From $3 a month - 2
Ant Design Icons
Free planAndroidiOSWeb7.1Free plan - 3
Shopify
Web7.1From $29 a month - 4
MUI
Free planWeb6.8From $299 a year - 5
Shadcn Studio Figma UI Kit
Free planWeb6.7$99 one-time - 6
Carbon Design System
Free planWeb6.6Free plan