Primer is the CSS framework that powers GitHub's front-end design. Primer CSS includes 23 packages that are grouped into 3 core meta-packages for easy install. Each package and meta-package is independently versioned and distributed via npm, so it's easy to include all or part of Primer within your own project.
The Primer CSS repo is managed as a monorepo that is composed of many npm packages.
Includes all 23 packages
$ npm install --save primer-css
The source files included are written in Sass (SCSS). After installing with npm, you can add your project's
node_modules directory to your Sass include paths (AKA load paths in Ruby), then import it like this:
You can import individual Primer modules by installing them with npm, for instance:
$ npm install --save primer-navigation
Then, you would import the module with:
Or, while you're figuring out which modules you need, you can import them directly from the
packages directory like so:
For a compiled CSS version of this module, an npm script is included that will output a CSS version to
build/build.css. The built CSS file is also included in the npm package.
$ npm run build
You can read more about primer in the docs.