11ty

Eleventy Documentation

This documentation is for an older version. Go to the newest Eleventy docs or check out the full release history.

Documentation Pages

Quick Tip #001—Inline Minified CSS

All Quick Tips

Originally posted on The Simplest Web Site That Could Possible Work Well on zachleat.com

This tip works well on small sites that don’t have a lot of CSS. Inlining your CSS removes an external request from your critical path and speeds up page rendering times! If your CSS file is small enough, this is a simplification/end-around for Critical CSS approaches.

Installation #

npm install clean-css to make the CSS minifier available in your project.

Configuration #

Add the following cssmin filter to your Eleventy Config file:

const CleanCSS = require("clean-css");
module.exports = function(eleventyConfig) {
eleventyConfig.addFilter("cssmin", function(code) {
return new CleanCSS({}).minify(code).styles;
});
};

Create your CSS File #

Add a sample CSS file to your _includes directory. Let’s call it sample.css.

body {
font-family: fantasy;
}

Capture and Minify #

Capture the CSS into a variable and run it through the filter (this sample is using Nunjucks syntax)

<!-- capture the CSS content as a Nunjucks variable -->
{% set css %}{% include "sample.css" %}{% endset %}
<!-- feed it through our cssmin filter to minify -->
<style>{{ css | cssmin | safe }}</style>