PostCSS plugin to add a collection of mixins, shortcuts, helpers and tools for your CSS
JavaScript CSS HTML
Latest commit aa917c5 Oct 30, 2016 @ismamz v0.6.1
Permalink
Failed to load latest commit information.
lib v0.6.1 Oct 30, 2016
media lint and readme tweaks May 6, 2016
test v0.6.1 Oct 30, 2016
.editorconfig first commit May 6, 2016
.gitignore first commit May 6, 2016
.npmignore first commit May 6, 2016
.travis.yml first commit May 6, 2016
CHANGELOG.md v0.6.1 Oct 30, 2016
LICENSE first commit May 6, 2016
README.md Add text-stroke Sep 26, 2016
index.js v0.6.0 Oct 23, 2016
package.json v0.6.1 Oct 30, 2016
test.js v0.6.0 Oct 23, 2016

README.md

PostCSS Utility Library Build Status

PostCSS Utility Library

Let's face it. You don't have time to write your own mixins, helpers or shortcuts for your next project. Let postcss-utilities help you instead.

postcss-utilities is a PostCSS plugin that includes the most commonly used mixins, shortcuts and helpers. It's as easy as specifying @util utility-name in your stylesheet, and postcss-utilities will handle the rest for you.

Check out the documentation to get started using postcss-utilities

Try it in the browser!

Motivation

PostCSS has a lot of plugins and some of them use non-standar CSS properties to work as mixins or helpers. This is not a best way for a PostCSS plugin, because developers will not understand what is the source of this property.

"This plugin saves us from many tiny plugins with unknown properties" @ai proposal postcss/issues/645

What is the difference between preprocessor’s mixins libraries?

  • You don’t need the extra files in your css codebase for mixins.
  • You don’t need mixins for vendor prefixing (use autoprefixer plugin)
  • You can use postcss-utilities with LESS, SASS, vanilla CSS or whatever you choice.

List of current utilities

IMPORTANT: The list of utilities is open for suggestions.

Examples

Input

.cfx {
    @util clearfix;
}

.box-16-9 {
    background-color: #ccc;
    margin-bottom: 20px;
    @util aspect-ratio(16:9);
}

Output

.cfx:after {
    content: '';
    display: block;
    clear: both;
}

.box-16-9 {
    background-color: #ccc;
    margin-bottom: 20px;
    position: relative;
    display: block;
    height: 0;
    padding: 0;
    overflow: hidden;
    padding-bottom: 56.25%;
}

Usage

postcss([ require('postcss-utilities') ])

See PostCSS docs for examples of your environment.

Contributing

The list of utilities is open for suggestions.

Contributors