primer/css

Primer is GitHub's design system. This is the CSS implementation

13,016

stars

6,504

commits

SCSS

primary language

Sep 11, 2026

updated

primer.style/css
css
design-system
design-systems
framework
meta
primer
primer-css
sass
styleguide
ui-components

README

Primer CSS

The CSS implementation of GitHub's Primer Design System

npm package build status contributors graph last commit license

:warning: This project is in KTLO mode! Use existing utility classes from this project where needed. For more complete patterns that include styling and markup, please use primer/react or, if necessary, primer/view_components.

Documentation

Our documentation site lives at primer.style/css. You'll be able to find detailed documentation on getting started, all of the components, our theme, our principles, and more.

Install

This repository is distributed with npm. After installing npm, you can install @primer/css with this command:

npm install --save @primer/css

Usage

The included source files are written in Sass using SCSS syntax. Once installed, you can add your project's node_modules directory to your Sass include paths (AKA load paths in Ruby), then import it like this:

@import "@primer/css/index.scss";

You can import individual Primer modules directly from the @primer/css package:

@import "@primer/css/core/index.scss";
@import "@primer/css/product/index.scss";
@import "@primer/css/marketing/index.scss";

Development

See DEVELOP.md for development docs.

Releasing (for GitHub staff)

You can find docs about our release process in RELEASING.md.

License

MIT © GitHub

Contributors

(top 30 of 172)

shawnbot

2,027 commits

jonrohan

1,138 commits

simurai

1,130 commits

dependabot[bot]

650 commits

primer/css

Primer is GitHub's design system. This is the CSS implementation

13,016

stars

6,504

commits

SCSS

primary language

Sep 11, 2026

updated

primer.style/css
css
design-system
design-systems
framework
meta
primer
primer-css
sass
styleguide
ui-components

README

Primer CSS

The CSS implementation of GitHub's Primer Design System

npm package build status contributors graph last commit license

:warning: This project is in KTLO mode! Use existing utility classes from this project where needed. For more complete patterns that include styling and markup, please use primer/react or, if necessary, primer/view_components.

Documentation

Our documentation site lives at primer.style/css. You'll be able to find detailed documentation on getting started, all of the components, our theme, our principles, and more.

Install

This repository is distributed with npm. After installing npm, you can install @primer/css with this command:

npm install --save @primer/css

Usage

The included source files are written in Sass using SCSS syntax. Once installed, you can add your project's node_modules directory to your Sass include paths (AKA load paths in Ruby), then import it like this:

@import "@primer/css/index.scss";

You can import individual Primer modules directly from the @primer/css package:

@import "@primer/css/core/index.scss";
@import "@primer/css/product/index.scss";
@import "@primer/css/marketing/index.scss";

Development

See DEVELOP.md for development docs.

Releasing (for GitHub staff)

You can find docs about our release process in RELEASING.md.

License

MIT © GitHub

Contributors

(top 30 of 172)

shawnbot

2,027 commits

jonrohan

1,138 commits

simurai

1,130 commits

dependabot[bot]

650 commits

Languages

SCSS

87.5%

JavaScript

10.5%

Shell

2.1%