node package manager
Love JavaScript? Your insights can make it even better. Take the 2017 JavaScript Ecosystem Survey »



Replace image urls to data uri. Also warns if a data uri would be duplicated, so developer can move them under one CSS rule to save size.

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-css-img-2-data-uri --save-dev

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


The "css_img_2_data_uri" task


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

    throwOnDuplicate: true,
    css_img_2_data_uri: {
        options: {
            files: [
                    src: 'path/to/source.css',
                    dest: 'path/to/output.css'
                    src: 'path/to/another/source.css',
                    dest: 'path/to/another/output.css'



Type: Array

List of css files which needs to be processed.


Type: Boolean

If set to true, it throws an error when the same image found twice, so the grunt build would stop.


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.