npm:northem-light

README

A north-bluish, light color palette.

Created for the clean- and minimal flat design pattern to achieve a optimal focus and readability for code syntax highlighting and UI. It consists of a total of sixteen, carefully selected, dimmed pastel colors for a eye-comfortable, but yet colorful ambiance.

This project is a light, more color-intensive variation of the origin project Northem.

The color palette it divided into four named components to represent the different color effects.

Northem Light Palette Overview

Northem Light colors are numbered from northem-light0 to northem-light15 where each component contains a different amount of colors:

Dark Water northem-light0 - northem-light3
Light Wind northem-light4 - northem-light6
Ice northem-light7 - northem-light10
Rainbow northem-light11 - northem-light15

This naming convention allows an uncomplicated use for terminals and preserves the compatibility to similar projects like base16.

Usage

To show a list of all available Gulp tasks run gulp or gulp help.

CSS

The CSS specification supports the usage of primitive value types to define custom properties which can be used to create e.g. color variables.
Northem provides the template-css.scss template file to compile a northem-light.css stylesheet.

The generated file contains all Northem Light color variables prefixed with -- inside the :root pseudo-class.
The :root pseudo-class represents an element that is the root of the document.
This is always the HTML (<html>) element which allows to use the Northem Light color variables for the whole document.

The northem-light.css stylesheet can be compiled via Gulp:

npm install
gulp compile-css-template

Sass

Copy the northem-light.scss file into your project and import it in your Sass files:

@import "northem-light";

The .scss file extension is optional.

SassDoc

Northem Light Sass sources are documented using the SassDoc documentation syntax which can be compiled to a HTML documentation via Gulp:

npm install
gulp sassdoc

The Sassdoc theme can be changed by editing the .sassdocrc configuration file.

LESSCSS

Copy the northem-light.less file into your project and import it in your LESSCSS files:

@import "northem-light";

Information about how the @import statement handles imports with different file extensions can be found in the official LESSCSS documentation.

KSS

Northem Light LESSCSS sources are documented using the KSS documentation syntax.
Information about the generation of a styleguide can be found in the official KSS documentation.