Header

Primer

GitHub's design system: Primer React components, Primitives design tokens, the Octicons icon set and public Figma libraries.

Design SystemsFreeOpen source
Visit Site

At a glance

Checked

Pricing
  • Free: Primer React and Primer CSS, both MIT licensed
From github.com/primer/react/blob/main/LICENSE, checked 21 Nov 2026
Licence
MIT, open source
GitHub
github.com/primer/react3.9k stars · 735 forks · written in TypeScriptLatest release @primer/react@38.46.0, 13 Nov 2026From GitHub, updated at every build
Made by
GitHub
Platforms
React apps in current Chrome, Firefox, Safari and Edge, with a Rails library now in maintenance mode

What it’s good for

Primer is the system GitHub uses to build GitHub. For product interfaces the @primer/react package supplies the components, installed alongside @primer/primitives, the design tokens for colour, size and typography, and react and react-dom from version 17 up. Primer CSS styles plain HTML to match GitHub.com, and wrapping rendered Markdown in a markdown-body container gives it GitHub's formatting. Octicons, GitHub's own SVG icon set, sits beside them.

Designers can add the Primer Web and Primer Primitives libraries from Primer's Figma Community profile, along with an Octicons file, while the mobile library stays internal. Brand UI covers marketing pages. Primer ViewComponents for Rails is in maintenance mode, and teams outside GitHub are advised to consider forking it. The code is free under the MIT licence.

Alternatives to Primer

All Design Systems tools

Questions

Can I use GitHub Primer in my own project?
Yes. Primer React is open source under the MIT licence, and the Primer Web and Primer Primitives Figma libraries are public on the Figma Community. Some guides and the Primer Mobile library are for GitHub staff only.
Does Primer support Ruby on Rails?
Primer ViewComponents implements Primer for Rails, but it is in maintenance mode. GitHub is moving its own apps to Primer React and suggests that teams outside GitHub fork the Rails library.