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 repo is managed as a monorepo that is composed of many NPM packages.
| Package | Version | Status |
|---|---|---|
| primer-css Includes all packages |
||
| primer-core | ||
| primer-product | ||
| primer-marketing |
This repository is distributed with npm. After installing npm, you can install primer-css with this command.
$ npm install --save primer-css
The source files included are written in Sass (scss) You can simply point your sass include-path at your node_modules directory and import it like this.
@import "primer-css/index.scss";You can also import specific portions of the module by importing those partials from the /lib/ folder. Make sure you import any requirements along with the modules.
For a compiled css version of this module, a 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.