Grunt Combine Media Queries Save

[DEPRECATED] A new version is managed here:

Project README

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 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-combine-media-queries --save-dev

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


The "cmq" task


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

  cmq: {
    your_target: {
      // Target-specific file lists and/or options go here.



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

  cmq: {
    options: {
      log: false
    your_target: {
      files: {
        'tmp': ['test/*.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.

Release History

  • 25-07-14 - v1.1.0
  • 13-02-14 - v1.0.12
  • 13-02-14 - v1.0.11
  • 13-02-14 - v1.0.10
  • 28-10-13 - v1.0.9 - Support dynamic mapping
  • 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'.
Open Source Agenda is not affiliated with "Grunt Combine Media Queries" Project. README Source: buildingblocks/grunt-combine-media-queries
Open Issues
Last Commit
6 years ago

Open Source Agenda Badge

Open Source Agenda Rating