Skip to content
On this page

Sourcemaps

Stylus supports basic sourcemaps according to the Sourcemap v3 spec

Create a sourcemap

Pass the --sourcemap flag (or -m) with a Stylus file. This will create a style.css file, and a style.css.map file as siblings to your style.styl and place a sourcemap link at the bottom of style.css to your sourcemap.

stylus -m style.styl
stylus -m style.styl

You can also run this command while watching a file. For instance: stylus -w -m style.styl. This will update your sourcemap everytime you save.

JavaScript API

Set the sourcemap setting with an options object or a boolean value:

var stylus = require('stylus');

var style = stylus(str)
  .set('filename', 'file.styl')
  .set('sourcemap', options);

style.render(function(err, css) {
  // generated sourcemap object
  console.log(style.sourcemap);
});
var stylus = require('stylus');

var style = stylus(str)
  .set('filename', 'file.styl')
  .set('sourcemap', options);

style.render(function(err, css) {
  // generated sourcemap object
  console.log(style.sourcemap);
});

Options

`comment`     Adds a comment with the `sourceMappingURL` to the generated CSS (default: `true`)
`inline`      Inlines the sourcemap with full source text in base64 format (default: `false`)
`sourceRoot`  "sourceRoot" property of the generated sourcemap
`basePath`    Base path from which sourcemap and all sources are relative (default: `.`)
`comment`     Adds a comment with the `sourceMappingURL` to the generated CSS (default: `true`)
`inline`      Inlines the sourcemap with full source text in base64 format (default: `false`)
`sourceRoot`  "sourceRoot" property of the generated sourcemap
`basePath`    Base path from which sourcemap and all sources are relative (default: `.`)