Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Stylus mixins, utilities, components, and gradient image generation


latest commit 061612cf80
Sean Lang slang800 authored
Failed to load latest commit information.
docs Add normalize
iconic update to match editorconfig & JSHint (mostly)
lib Add normalize
test improve comments for test runner
.editorconfig add an editorconfig
.gitignore ignore *.swp files
.npmignore gitignore
.travis.yml make sure npm is updated for travis
LICENSE update copyright year Add normalize
index.styl closes #206
package.json 1.1.0

Build Status


Stylus mixins, utilities, components, and gradient image generation. Don't forget to check out the documentation.


$ npm install nib

If the image generation features of Nib are desired, such as generating the linear gradient images, install node-canvas:

$ npm install canvas

JavaScript API

Below is an example of how to utilize nib and stylus with the connect framework (or express).

var connect = require('connect')
  , stylus = require('stylus')
  , nib = require('nib');

var server = connect();

function compile(str, path) {
  return stylus(str)
    .set('filename', path)
    .set('compress', true)

    src: __dirname
  , compile: compile

Stylus API

To gain access to everything nib has to offer, simply add:

  @import 'nib'

Or you may also pick and choose based on the directory structure in ./lib, for example:

  @import 'nib/gradients'
  @import 'nib/overflow'
  @import 'nib/normalize'

To be continued...

More Information


You will first need to install the dependencies:

    $ npm install -d

Run the automated test cases:

    $ npm test

For visual testing run the test server:

    $ npm run-script test-server

Then visit localhost:3000 in your browser.


I would love more contributors. And if you have helped out, you are awesome! I want to give a huge thanks to these people:

Something went wrong with that request. Please try again.