scss-lint
is a tool to help keep your SCSS files
clean and readable. You can run it manually from the command-line, or integrate
it into your SCM hooks. It uses rules
established by the team at Causes.com.
- Requirements
- Installation
- Usage
- Configuration
- Linters
- Editor Integration
- Git Integration
- Contributing
- Changelog
- License
- Ruby 1.9.3+
- Files you wish to lint must be written in SCSS (not Sass) syntax
gem install scss-lint
Run scss-lint
from the command-line by passing in a directory (or multiple
directories) to recursively scan:
scss-lint app/assets/stylesheets/
You can also specify a list of files explicitly:
scss-lint app/assets/stylesheets/**/*.css.scss
scss-lint
will output any problems with your SCSS, including the offending
filename and line number (if available).
Command Line Flag | Description |
---|---|
-c /--config |
Specify a configuration file to use |
-e /--exclude |
Exclude one or more files from being linted |
-f /--format |
Output format (Default , XML , Files ) |
-i /--include-linter |
Specify which linters you specifically want to run |
-x /--exclude-linter |
Specify which linters you don't want to run |
-h /--help |
Show command line flag documentation |
--show-linters |
Show all registered linters |
-v /--version |
Show version |
scss-lint
will automatically recognize and load any file with the name
.scss-lint.yml
as a configuration file. It loads the configuration based on
the location of the file being linted, starting from that file's directory and
ascending until a configuration file is found. Any configuration loaded is
automatically merged with the default configuration (see config/default.yml
).
Here's an example configuration file:
inherit_from: '../../inherited-config.yml'
exclude: 'app/assets/stylesheets/plugins/**'
linters:
BorderZero:
enabled: false
exclude:
- 'path/to/file.scss'
Indentation:
enabled: true
width: 2
All linters have an enabled
option which can be true
or false
, which
controls whether the linter is run, along with linter-specific options. The
defaults are defined in config/default.yml
.
The inherit_from
directive allows a configuration file to inherit settings
from another configuration file. The file specified by inherit_from
is loaded
and then merged with the settings in the current file (settings in the current
file overrule those in the inherited file).
The exclude
directive allows you to specify a glob pattern of files that
should not be linted by scss-lint
. Paths are relative to the location of the
config file itself if they are not absolute paths. If an inherited file
specifies the exclude
directive, the two exclusion lists are combined. Any
additional exclusions specified via the --exclude
flag are also combined. If
you need to exclude files for a single linter you can specify the list of files
using the linter's exclude
configuration option.
You can also configure scss-lint
by specifying a file via the --config
flag, but note that this will override any configuration files that scss-lint
would normally find on its own (this can be useful for testing a particular
configuration setting, however). Configurations loaded this way will still be
merged with the default configuration specified by config/default.yml
.
scss-lint
is a customizable tool with opinionated defaults that helps you
enforce a consistent style in your SCSS. For these opinionated defaults, we've
had to make calls about what we think are the "best" style conventions, even
when there are often reasonable arguments for more than one possible style.
Should you want to customize the checks run against your code, you can do so by editing your configuration file to match your preferred style.
You can have scss-lint
automatically run against your SCSS files after saving
by using the Syntastic plugin. If
you already have the plugin, just add
let g:syntastic_scss_checkers = ['scss_lint']
to your .vimrc
.
Install the Sublime scss-lint plugin.
If you'd like to integrate scss-lint
into your Git workflow, check out our
Git hook manager, overcommit.
We love getting feedback with or without pull requests. If you do add a new feature, please add tests so that we can avoid breaking it in the future.
Speaking of tests, we use rspec
, which can be run like so:
bundle exec rspec
If you're interested in seeing the changes and bug fixes between each version
of scss-lint
, read the SCSS-Lint Changelog.
This project is released under the MIT license.