node package manager
Easy collaboration. Discover, share, and reuse code in your team. Create a free org »



Build Status Dependency Status

A Stylus plugin for Metalsmith.


npm install --save metalsmith-stylus

Getting Started

If you haven't checked out Metalsmith before, head over to their website and check out the documentation.

CLI Usage

If you are using the command-line version of Metalsmith, you can install via npm, and then add the metalsmith-stylus key to your metalsmith.json file:

  "plugins": {
    "metalsmith-stylus": {}

JavaScript API

If you are using the JS Api for Metalsmith, then you can require the module and add it to your .use() directives:

var stylus = require('metalsmith-stylus');


All option keys will be passed to stylus' set method, except define and use.

To use stylus plug-ins like nib or autoprefixer, add them as array to use:

var stylus = require('metalsmith-stylus');
var nib = require('nib');
    // Set stylus output to compressed 
    compress: true,
    // Use the 'nib' plug-in 
    use: [nib()],
    // Inline images as base64 
    define: {
        url: stylus.url()