Keep your styles piping hot! Rebuild your styles on change without binaries


Similar stuff to piping and piping-browser but for stylesheets. currently supports stylus with (optional) nib.

npm install piping-styles

Piping-styles is not a binary, so you can continue using your current workflow for running your application ("wooo!"). Basic usage is as follows:

  • main _(path)_: The path to your top style
  • out _(path)_: The path to where you want your css to be written to. Relative to the file where piping-styles was required
  • ignore _(regex)_: Files/paths matching this regex will not be watched. Defaults to /(\/\.|~$)/
  • minify _(boolean)_: Whether to minify all css output. Defaults to false
  • watch _(boolean)_: Whether or not piping should rebuild on changes. Defaults to true, could be set to false for production
  • includeModules _(boolean)_: Whether to include files located in node_modules folders when watching. defaults to false
  • vendor _(object)_: Specify configuration for building vendor files. Vendor files are concatenated in order, and written to the given path.
    • path _(string)_: Directory where vendor files are located, relative to file where piping-styles was required
    • out _(string)_: Path where vendor ouput should be written, relative to the file where piping-styles was required
    • files _(array)_: Array of vendor files, relative to vendor path.
  • build _(object)_: An object that maps file extensions, eg ".styl" to functions that take a filename, file data, and a callback and compile the source, sending it to the callback.

Piping-styles can also be used just by passing two strings. In this case, the strings are taken as the main and out options


piping-styles plays nice with piping. To use it, ensure piping-styles is required when piping returns false:

// application logic here