Preprocess and validate SUIT CSS components

This task will build CSS components via the SUIT CSS preprocessor

This plugin requires Grunt ~0.4.0

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-suitcss --save-dev

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

grunt.loadNpmTasks('grunt-suitcss');

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

grunt.initConfig({
  suitcss: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    },
  },
});

Type: Boolean Default value: true

Pass each component through the Rework Suit Conformance library. If conformance fails an error will be output to the CLI and the task will be stopped

Type: Object Default value: { install: true }

Options that can be passed to the component-resolver.

Note: verbose is always set to true to allow output to the CLI

Type: Object Default value: {}

Options that can be passed to the SUIT CSS preprocessor

Note: Working examples can be found in the /test directory

The SUIT preprocesser makes use of rework-npm to allow importing of dependencies from npm or local folders. Pass the task a file with imports and they will be resolved. This method is the favoured approach to building components.

grunt.initConfig({
  suitcss: {
    your_target: {
      files: {
        'dest/built.css': ['suit_components/main.css'],
      }
    }
  }
});

In this example, the default options are used to build a SUIT CSS component. The source file must be a component.json file for the task to know it has to fetch dependencies and build them. Each component is passed through the conformance checker and the resulting file is then passed through the SUIT CSS preprocessor.

grunt.initConfig({
  suitcss: {
    your_target: {
      files: {
        'dest/built.css': 'path/to/component.json',
      }
    }
  },
});

It's possible to use SUIT CSS components even if component(1) or rework-npm are not used, for example installing them from a different package manager like Bower. In this case passing the task one or more CSS files will mean they are checked for conformance individually and then preprocessed as a complete package. They are built in the order they are passed in.

grunt.initConfig({
  suitcss: {
    your_target: {
      files: {
        'dest/built.css': ['components/tweet.css', 'components/button.css'],
      }
    }
  }
});

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

See GitHub releases