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

At a glance
Checked
- Pricing
- Free: Primer React and Primer CSS, both MIT licensed
- 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
- Website
- primer.style
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 toolsQuestions
- 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.



