Total Pageviews

Friday, 24 June 2016

Primer CSS

Our internal CSS toolkit and guidelines. 

NPM version Build Status
Primer is the CSS toolkit that powers GitHub's front-end design. It's purposefully limited to common components to provide our developers with the most flexibility, and to keep GitHub uniquely GitHubby. It's built with SCSS and available via NPM, so it's easy to include all or part of it within your own project.
This repository is a compilation of several CSS modules.


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_modulesdirectory 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.