NAME

       Plack::Middleware::File::Sass - Sass and SCSS support for all Plack frameworks

SYNOPSIS

         use Plack::App::File;
         use Plack::Builder;

         builder {
             mount "/stylesheets" => builder {
                 enable "File::Sass";
                 Plack::App::File->new(root => "./stylesheets");
             };
         };

         # Or with Middleware::Static
         enable "File::Sass", syntax => "scss";
         enable "Static", path => qr/\.css$/, root => "./static";

DESCRIPTION

       Plack::Middleware::File::Sass is a Plack middleware component that works with
       Plack::App::File or Plack::Middleware::Static to compile Sass <http://sass-lang.com/>
       templates into CSS stylesheet in every request.

       When a request comes in for .css file, this middleware changes the internal path to .sass
       or .scss, depending on the configuration, in the same directory. If the Sass template is
       found, a new CSS stylesheet is built on memory and served to the browsers.  Otherwise, it
       falls back to the original .css file in the directory.

       This middleware should be very handy for the development. While Sass to CSS rendering is
       reasonably fast, for the production environment you might want to precompile Sass
       templates to CSS files on disk and serves them with a real web server like nginx or
       lighttpd.

SASS BACKENDS

       If you have the sass gem version higher than 3 installed and have the "sass" executable
       available in your PATH, this module automatically uses the command to convert Sass or SCSS
       into CSS. If the command is not available and you have Text::Sass perl module available,
       it will be used. Otherwise you'll get an exception during the initialization of this
       middleware component.

OPTIONS

       syntax
           Defines which syntax to use. Valid values are sass and scss. Defaults to sass.

AUTHOR

       Tatsuhiko Miyagawa <miyagawa@bulknews.net>

LICENSE

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.

SEE ALSO

       Plack::App::File Text::Sass <http://sass-lang.com/>