# @primer/css

> The CSS implementation of GitHub's Primer Design System

Latest version **22.3.3** (published 2026-10-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install @primer/css
pnpm add @primer/css
yarn add @primer/css
bun add @primer/css
```

## Health

**Score 70/100 (B)** — status: active.

Positive: esm support; no vulnerabilities; has provenance; recently updated; high maintenance score; popular repo.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 22.3.3 |
| Published | 2026-10-29 |
| First published | 2019-02-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=16.0.0 |
| Dependencies | 0 |
| Unpacked size | 6.5 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 13036 |
| Author | GitHub, Inc. |
| Maintainers | primer-css |
| Keywords | primer, css, github, design-system |

## Links

- npm: https://www.npmjs.com/package/@primer/css
- Repository: https://github.com/primer/css
- Homepage: https://primer.style/css
- Issues: https://github.com/primer/css/issues
- npm.io page: https://npm.io/package/@primer/css

## Alternatives

- [style-dictionary](https://npm.io/package/style-dictionary.md) — 2.0M weekly downloads
- [postcss-merge-idents](https://npm.io/package/postcss-merge-idents.md) — 1.7M weekly downloads
- [@fontsource/noto-sans](https://npm.io/package/@fontsource/noto-sans.md) — 93.0K weekly downloads
- [uglifycss](https://npm.io/package/uglifycss.md) — 71.6K weekly downloads
- [mat4-interpolate](https://npm.io/package/mat4-interpolate.md) — 23.3K weekly downloads

## Recent versions

- 22.3.3 (latest) — 2026-10-29
- 0.0.0-20261111053454 (canary) — 2026-11-11
- 22.3.3-rc.5caa2e7e (next) — 2026-10-21
- 0.0.0-20261110180846 — 2026-11-10
- 0.0.0-20261109055406 — 2026-11-09
- 0.0.0-20261108053643 — 2026-11-08
- 0.0.0-20261106053413 — 2026-11-06
- 0.0.0-20261103221001 — 2026-11-03
- 0.0.0-20261103185902 — 2026-11-03
- 0.0.0-20261102214714 — 2026-11-02
- 0.0.0-20261101053923 — 2026-11-01
- 0.0.0-20261030053552 — 2026-10-30
- 0.0.0-20261029142627 — 2026-10-29
- 0.0.0-20261029142247 — 2026-10-29
- 0.0.0-20261029140238 — 2026-10-29
- … 3898 more at https://npm.io/package/@primer/css/versions

## README

# Primer CSS
The CSS implementation of GitHub's Primer Design System

[![npm package](https://img.shields.io/npm/v/@primer/css.svg)](https://www.npmjs.com/package/@primer/css)
[![build status](https://github.com/primer/css/actions/workflows/ci.yml/badge.svg)](https://github.com/primer/css/actions/workflows/ci.yml)
[![contributors graph](https://img.shields.io/github/contributors/primer/css.svg)](https://github.com/primer/css/graphs/contributors)
[![last commit](https://img.shields.io/github/last-commit/primer/css.svg)](https://github.com/primer/css/commits/main)
[![license](https://img.shields.io/github/license/primer/css.svg)](https://github.com/primer/css/blob/main/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](https://github.com/primer/react) or, if necessary, [primer/view_components](https://github.com/primer/view_components).

## Documentation
Our documentation site lives at [primer.style/css](https://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][install-npm], you can install `@primer/css` with this command:

```sh
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](https://github.com/sass/node-sass#includepaths) (AKA [load paths](http://technology.customink.com/blog/2014/10/09/understanding-and-using-sass-load-paths/) in Ruby), then import it like this:

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

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

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

## Development
See [DEVELOP.md](DEVELOP.md) for development docs.

## Releasing (for GitHub staff)
You can find docs about our release process in [RELEASING.md](RELEASING.md).

## License

[MIT](./LICENSE) &copy; [GitHub](https://github.com/)


[install-npm]: https://docs.npmjs.com/getting-started/installing-node
[npm]: https://www.npmjs.com/
[sass]: http://sass-lang.com/

---
_Source: https://npm.io/package/@primer/css · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
