grunt-critical-assets-html

Finds all the css/js/image links and put inline in the HTML

Getting Started

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-critical-assets-html--save-dev

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

grunt.loadNpmTasks('grunt-critical-assets-html');

The "critical_assets_html" task

Overview

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

grunt.initConfig({
  critical_assets_html: {
    options: {
      ignoreJs: false,
      ignoreCss: false,
      ignoreImg: false
    },
    all: {
      files: {
          'dist/html-assets-inline.html': 'test/index.html'
        }
    }
  },
});

For register the task use grunt.registerTask('default', ['critical_assets_html'])

Multiples HTML with different options

You can use different options run various sub-taks, for example:

grunt.initConfig({
  critical_assets_html: {
      default: {
        options: {
          ignoreJs: false,
          ignoreCss: false,
          ignoreImg: false
        },
        files: {
            'tmp/default_options.html': 'test/fixtures/index.html'
        }        
      },
      minifyCSS: {
        options: {
          ignoreJs: false,
          ignoreCss: false,
          ignoreImg: false,
          minifyCSS: true
        },
        files: {
            'tmp/minifyCSS_options.html': 'test/fixtures/index2.html'
          }        
      },
      minifyJs: {
        options: {
          ignoreJs: false,
          ignoreCss: false,
          ignoreImg: false,
          minifyCSS: false,
          minifyJs: true
        },
        files: {
            'tmp/minifyJs_options.html': 'test/fixtures/index3.html'
          }        
      }
  },
});

A with option to minify CSS/Js in index2.html/index3.html and other with default options.

Options

ignoreJs: default "false" try insert inline javascript in the HTML, if "true" will be ignore the javascripts.

ignoreCss: default "false" try insert inline CSS in the HTML, if "true" will be ignore the CSS.

ignoreImg: default "false" try insert inline image in base64 in the HTML, if "true" will be ignore the images.

minifyCSS: default "false", if "true" will be minified the CSS.

minifyJs: default "false", if "true" will be minified the JavaScript.

Contributing

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.