piping-styles

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

Piping-styles

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:

require("piping-styles")({main:"./client/styles/app.styl",out:"./public/app.css"});
  • 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 /(\/\.|~$)/
  • watch _(boolean)_: Whether or not piping should rebuild on changes. Defaults to true, could be set to false for production
  • 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

require("piping-styles")("./client/styles/app.styl","./public/app.css");

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

if(!require("piping")()){
  require("piping-styles")("./client/styles/app.styl","./public/app.css");
  return;
}
// application logic here