node package manager

grunt-kss

KSS style guide generator for grunt.

grunt-kss

KSS style guide generator for grunt.

This plugin requires Grunt ~1.0.0. If you still use Grunt 0.4.x, you can use the 4.x versions of grunt-kss.

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-kss --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-kss');

In your project's Gruntfile, add a section named kss to the data object passed into grunt.initConfig().

Here's an example:

grunt.initConfig({
  kss: {
    options: {
      verbose: true
    },
    dist: {
      src: ['/path/to/sourcedir'],
      dest: '/path/to/destdir'
    }
  }
})

Type: String Default value: null

Use a custom template to build your style guide.

Type: String or array of String Default value: null

Specify location(s) of custom handlebars helpers; see http://bit.ly/kss-helpers

Type: String Default value: null

Use a custom mask for detecting stylesheets.

Type: String or array of String Default value: null

Use custom property name(s) when parsing KSS comments.

Type: String or array of String Default value: null

Adds CSS stylesheet(s) to your style guide.

Type: String or array of String Default value: null

Adds JavaScript file(s) to your style guide.

Type: String Default value: null

Loads the kss-node configuration from a JSON file.

In lieu of a formal style guide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

  • v5.0.0: Update to KSS 3.0.0, Grunt 1.0.0, and Node.js 4.0.0 or later.
  • v4.0.0: Update to KSS 2.4.0.
  • v1.0.0: Don't ask.
  • v0.2.6: Fix "Error: spawn ENOENT" bug for Windows.
  • v0.2.4: Fix kss-node module path.
  • v0.2.3: Bump version.
  • v0.2.2: Fix README.
  • v0.2.0: Fix a cmd path.
  • v0.1.0: Release.