whatisgithub

What is css?

primer/css — explained in plain English

Analysis updated 2026-06-24

12,943SCSSAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

GitHub's official CSS design system available as an npm package for anyone to use in their own projects. Currently in maintenance-only mode, no new features are being added.

Mindmap

mindmap
  root((primer/css))
    What it does
      GitHub visual styles
      SCSS utility classes
      Sub-module imports
    Use Cases
      Style web projects
      Match GitHub look
      Reference design
    Tech Stack
      SCSS
      CSS
      npm
    Audience
      Web developers
      GitHub builders
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Apply GitHub's exact visual styling to your own web project by importing Primer CSS into your SCSS files.

USE CASE 2

Include only the styles you need by importing sub-modules for core, product, or marketing styles separately.

USE CASE 3

Inspect how GitHub.com's design system is structured in CSS for learning or reference.

What is it built with?

SCSSCSSnpm

How does it compare?

primer/cssselectize/selectize.jstwbs/bootstrap-sass
Stars12,94313,02712,506
LanguageSCSSSCSSSCSS
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
Use freely for any purpose including commercial projects, just keep the copyright notice. MIT license.

So what is it?

Primer CSS is the CSS stylesheet implementation of GitHub's Primer design system. GitHub uses Primer to build the visual appearance of GitHub.com itself, and this package makes those same styles available for anyone to use in their own projects. It is written in SCSS, which is a version of CSS that adds variables, nesting, and other features before compiling down to regular CSS that browsers understand. The README includes an important notice: this project is currently in what GitHub calls KTLO mode, meaning Keep the Lights On. In practice, this means the project receives only minimal maintenance to stay functional, with no active feature development. Users who need complete, fully styled components including both the HTML markup and the CSS are directed to two other projects: primer/react (a React component library) and primer/view_components (a Ruby on Rails component library). Both of those are under active development and include more complete patterns. For projects already using Primer CSS, the package is installed via npm and imported into your SCSS files with a single import statement. You can import the entire package at once or bring in smaller sub-modules for core styles, product styles, or marketing styles separately, which allows you to include only what a specific page needs. Full documentation including all available utility classes, the design theme, and usage guidance lives at primer.style/css. The package is released under the MIT license and was created by GitHub.

Copy-paste prompts

Prompt 1
I'm building a web app and want it to look like GitHub. Show me how to install primer/css via npm and import only the core styles into my SCSS file.
Prompt 2
Using primer/css, write a sample HTML page that uses Primer utility classes for layout and typography.
Prompt 3
I'm migrating from primer/css to primer/react. What are the equivalent React components for the Primer CSS utility classes I've been using?
Prompt 4
Show me how to import just the marketing sub-module from primer/css without pulling in the full stylesheet.

Frequently asked questions

What is css?

GitHub's official CSS design system available as an npm package for anyone to use in their own projects. Currently in maintenance-only mode, no new features are being added.

What language is css written in?

Mainly SCSS. The stack also includes SCSS, CSS, npm.

What license does css use?

Use freely for any purpose including commercial projects, just keep the copyright notice. MIT license.

How hard is css to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is css for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.