# Combine media queries

> Combine matching media queries into one media query definition. Useful for CSS generated by preprocessors using nested media queries.

This was written as a solution to a problem we have using LESS CSS for our mobile first sites.

## Getting Started
This plugin requires Grunt `~0.4.1`

If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

```shell
npm install grunt-combine-media-queries --save-dev
```

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

```js
grunt.loadNpmTasks('grunt-combine-media-queries');
```

## The "cmq" task

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

```js
grunt.initConfig({
  cmq: {
    your_target: {
      // Target-specific file lists and/or options go here.
    },
  },
})
```

### Options

#### log

Type: `boolean`
Default: `false`

Log processed media queries.

### Usage Examples

#### Default Options
In this example, all the css files in `test` are processed and moved to the folder `tmp`

```js
grunt.initConfig({
  cmq: {
    options: {
      log: false
    },
    your_target: {
      files: {
        'tmp': ['test/*.css']
      }
    }
  }
})
```

## Contributing
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](http://gruntjs.com/).

## Release History
* 28-10-13 - v1.0.8 - Package.json fix
* 27-10-13 - v1.0.7 - Package.json fix
* 01-09-13 - v1.0.6 - Comments are now preserved in CSS output.
* 30-07-13 - v1.0.2 - Ordering now done by min-width, min-height, max-width, max-height and print.
* 26-07-13 - v1.0.1 - Breaking change task name changed to `cmq`.
* 26-07-13 - v1.0.0 - Initial release. Currently only works for CSS written mobile-first and will only order by 'min-width'.