primer-support

Sass variables, mixins, and functions for use in our components.

Usage no npm install needed!

<script type="module">
  import primerSupport from 'https://cdn.skypack.dev/primer-support';
</script>

README

Primer Support

npm version Build Status

Support files are Sass variables, mixins, and functions that we import into different bases for use across components, objects, and utilities. Sharing these common properties across GitHub sites helps us to keep our styles more consistent.

Most of the time to include these you'll only need to add @import "support/support"; to the top of your bundle. If you want only a specific partial you can import them separately.

This repository is a module of the full primer repository.

Install

This repository is distributed with npm. After installing npm, you can install primer-support with this command.

$ npm install --save primer-support

Usage

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-support/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.

Documentation

Primer is built on systems that form the foundation of our styles, and inform the way we write and organize our CSS. Building upon systems helps us make styles consistent and interoperable with each other, and assists us with visual hierarchy and vertical rhythm.

We use Sass variables to keep color, typography, spacing, and other foundations of our system consistent. Occasionally we use Sass mixins to apply multiple CSS properties, they are a convenient solution for frequently-used verbose patterns.

We've documented variables, mixins, and the systems they are built on for the following:

License

MIT © GitHub