0.0.13 • Public • Published

    uselesscss Build Status

    Trim bloat from your CSS by only including rules that will actually be active.

    The goal behind this project is to speed up websites and make for cleaner resulting code by only including what you need. A perfect use case, for example, would be if you were using a large framework, like Bootstrap, in combination with a static site generator, like Jekyll.


    npm install uselesscss # you can add -g for a global install, available from the command line 


    You can use uselesscss through the command line interface or as a library

    Command line interface

      uselesscss [options] <html> ([-] | [<css>])
      -h --help  Show this message
      --version  Print version

    Where <html> and <css> are local paths to their respective files. Also, you can supply - instead of a <css>, to pass in STDIN or pipe in output from another program.

    To save the resulting output, redirect it to a file. E.g.

    ./bin/uselesscss ~/index.html ~/Developer/my-site/big.css > ~/small.useless.css

    The pipe syntax (i.e. -) is useful when used with a build pipeline or want to pass in a remote file. E.g.

    curl -L | ./bin/uselesscss ~/index.html - > bootstrap.useless.css


    var Useless = require('uselesscss')
    var reducedCss = Useless(html, css)

    Where html and css are strings.

    Example results

    The following examples can be found in the example section of this project. They can be generated easily by running

    ./bin/uselesscss example/foundation/kitchen_sink.html example/foundation/css/docs.css > example/foundation/css/docs.useless.css
    ./bin/uselesscss example/bootstrap/bootswatch.html example/bootstrap/css/bootstrap.css > example/bootstrap/css/bootstrap.useless.css

    The resulting output is as follows:

    Framework HTML Original CSS New CSS Original size New size % reduction
    Foundation kitchen_sink.html docs.css docs.useless.css 288KB 84KB 70%
    Bootstrap bootswatch.html bootstrap.css bootstrap.useless.css 146KB 48KB 67%

    The above examples were chosen because their original intent is to demonstrate the full capabilities of their respective frameworks. Still, we see pretty good file size reductions. For more realistic projects, such as my personal site, which make much more sparse use of such frameworks, the reduction is closer to 97%!


    npm i uselesscss

    DownloadsWeekly Downloads






    Last publish


    • asimpletune