Linting module for Mimosa browser development workflow tool
JavaScript CoffeeScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This is a Mimosa module that merges both CSSLint and JSHint to run static analysis on both your CSS and JS within the same configuration.

This module, prior to Mimosa version 1.1.0 was a default Mimosa module and came bundled with it. As of that version it was replaced with two modules, one each for JSHint and CSSLint.


Include "lint" in your modules list. That is all, Mimosa will install it for you the next time you start up a build or watch.


To 'lint' code is to check it for common mistakes or variances from the idiom. Using the mimosa-lint module, Mimosa will automatically lint all of the CSS and JavaScript it moves from source directories to compiled directories. Any errors or warnings that come out of linting will be printed to the console but will not stop or fail the compilation.

Default Config

    javascript: true
    css: true
    javascript: false
    css: false
    jshintrc: ".jshintrc"
      plusplus: true     # an example, not a default
      floats: false      # an example, not a default
  • exclude: an array of strings or regexes that match files to not lint. Strings are paths that can be relative to the watch.compiledDir or absolute.
  • compiled: The compiled block controls whether or not linting is enabled for compiled code. So when Mimosa compiles SASS, LESS or Stylus, Mimosa will send the resulting CSS through a linting process. Similarly for the JavaScript transpilers, Mimosa will lint the resulting JavaScript.
  • copied: The copied settings determine whether or not to lint copied files, like hand-coded JavaScript.
  • vendor: Linting is, by default, disabled for vendor assets, that is, those assets living inside a vendor.javascripts directory. Vendor libraries often break from the idiom or use hacks to solve complex browser issues for you. For example, when run through CSSLint, Bootstrap causes 400+ warnings. To enable vendor asset linting, uncomment and enable the setting and switch the flags to true.
  • rules: The rules block is where linting rules for each of the linting tools are overridden or changed. Example overrides are provided in the default configuration. Those are examples, they are not actually overrides.
  • rules.js: The list of JSHint rules can be found here:
  • rules.css: The list of CSSLint rules can be found here:

Default, Implied Rules

For CoffeeScript and IcedCoffeeScript some jshint rules are turned off by default. Those transpilers output JavaScript that violates jshint and there is nothing that can be done other than turn the rules off. So when compiling those files, Mimosa will turn off the listed rules by default.

boss: true
eqnull: true
shadow: true
expr: true