bnowack / scss-watcher
SCSS Watcher for multiple and/or nested directories
README
The SCSS Watcher is a PHP class that recursively monitors a directory for changed .scss files and generates .css versions.
It requires a sass binary to be installed.
The CSS files are generated in css directories at the same level as the corresponding scss directory, e.g.:
/myproject/module1/scss/module1.scss
/myproject/module2/scss/module2.scss
=>
/myproject/module1/css/module1.css
/myproject/module2/css/module2.css
SCSS files with a leading _ in the filename are treated as SCSS configuration files (e.g. for mixins).
A change to a system file triggers a re-build of all CSS files.
Installation
Add the repository reference to your composer.json:
"require-dev": {
"bnowack/scss-watcher": "1.0.0"
}
Usage
Ideally, the SCSS Watcher is run from the command line. A script is provided:
php scripts/watch.php --path=/path/to/entry/directory
or (from your repository root):
php vendor/bnowack/scss-watcher/scripts/watch.php --path=src --bin=/usr/bin/sass
The "bin" parameter is optional. It can be used when auto-detection cannot find the sass binary. On Windows machines the command usually looks like this:
php vendor/bnowack/scss-watcher/scripts/watch.php --path=src --bin=C:\Ruby\bin\sass