Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fix your mobile-first CSS for legacy browsers
Latest commit 71a4aa2 Robin Pokorný Merge pull request #8 from 2ndkauboy/master
fixing missing colons in config examples
Failed to load latest commit information.
tasks Add colours and report tothe output
test Add option to include only overrides, closes #4
.editorconfig Initial functionality v0.1.0
Gruntfile.js Add option to include only overrides, closes #4
LICENSE Initial functionality v0.1.0 fixing missing colons in config examples
package.json Add colours and report tothe output

grunt-legacssy Dependency Status

Fix your CSS for legacy browsers

Getting Started

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

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


The "legacssy" task


Run this task with the grunt legacssy command.

The task concats provided styles and when it finds unsupported (i.e. CSS3) @media query it tests the min-width and max-width and if it matches the rules inside the @media are included in the resulting style.

Task targets, files and options may be specified according to the grunt Configuring tasks guide.



type: Number Default: 1024


Type: Boolean Default: True

Unsupported media queries are flattened only if their min-width and max-width match with legacyWidth. Comparision is number only, that means it is compatible with both px's and em's as long as there is only one of them used.


Type: Boolean Default: False

Please note this might change the desired outcome, see the corresponding issue comment.

Usage Examples

Default Options

  legacssy: {
    dist: {
      files: {
        'css/style-legacy.css': 'css/style.css',

Default Options

  legacssy: {
    dist: {
      options: {
        // Include only styles for a screen 800px wide
        legacyWidth: 800
      files: {
        'css/style-legacy.css': 'css/style.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

  • v0.4.0 Add colours and report to the output
  • v0.3.0 Output only overrides
  • v0.2.0   Media matching added * v0.1.0   Initial task with basic functionality.

Bitdeli Badge

Something went wrong with that request. Please try again.