Primer
GitHub's design system: 62 React components, Octicons and design tokens
Tier B · UsefulDesign System DocsComponent LibraryBrand Guidelinesprimer.style
Primer is the design system behind GitHub. The site is the hub for Product UI (62 documented React components plus a Rails ViewComponent and a CSS implementation), Brand UI and the brand toolkit, and Foundations — accessibility guidance, Octicons, and colour, spacing and typography tokens. Primer's real value outside GitHub is its written guidance and its component anatomy docs, which are more thorough than most public systems.
npm install @primer/reactFor an agent
Do not install @primer/react for a generic product — it carries GitHub's visual identity and its trademark restrictions, and it is far less adopted (3.9k stars) than MUI or antd. Read it instead: the component anatomy, ActionList and SelectPanel patterns, PageLayout and the accessibility Foundations are among the best-written public references for how to structure a dense developer tool, and Octicons (github.com/primer/octicons, MIT) is genuinely reusable on its own. If you are building a GitHub App or Action UI, then Primer is the correct and expected choice.
Why it is here. One of the few public design systems maintained at real product scale, with the written rationale left in — the guidance is worth more to an agent than the npm package.
Facts
- License
- MIT, Trademark / trade dress restricted
- Pricing
- Free, Open source
- Framework
- React, Vanilla JS, Web Components
- Styling
- CSS Modules, CSS custom properties, Vanilla CSS
- Distribution
- npm package, GitHub repository, Figma file or kit
- Platform
- Web
- Content type
- Code, Prose / writing, Design tokens / theme files, Icons, Figma / design source files
- Agent readiness
- Structured documentation, Readable open source
- Accessibility
- WCAG 2.x AA, Full ARIA pattern implemented, Keyboard navigable, Focus management and visible focus, Screen reader tested, Semantic HTML
- Maturity
- Actively maintained
- GitHub stars
- 3,886
- Package
- @primer/react
Components it ships
62 totalHelps you build
15Notable for
- 62 documented React components
- Octicons SVG icon set
- Rails ViewComponent implementation
- primer/css with 13k stars
- GitHub brand toolkit and design tokens
Provenance
Verified 2026-08-16. HTTP 200. https://primer.style/, https://primer.style/components (62 components enumerated), api.github.com/repos/primer/react, api.github.com/orgs/primer/repos, llms.txt returns 404
Also in Design Systems & Brand Guidelines
6- ARIA Authoring Practices Guide · W3C's 30 canonical widget patterns with keyboard maps and working HTML examples
- Branding Style Guides · Archive of ~3,840 real brand guideline PDFs, filterable by year, region and industry
- Material Design 3 · Google's open design system: 39 components, tokens, and Compose/Web code
- Modal · Python serverless GPU platform whose site is a dev-tool marketing design reference
- NameThatUI · Visual dictionary that maps 76 web and macOS UI elements to their real names and code
- The Component Gallery · 60 UI components cross-referenced against 95 real design systems