Shubham Verma

How to automate image compression with Git Hooks

This story is kind of story and tutorial mix. It consist following parts:

So without delay let’s get started. WHY,WHAT AND HOW :-)

Why we need to compress images?

This tutorial is not about why we need to compress images. There are already ton of good resources over the internet of this. In summary:

That’s it there is a lot more information about this. But there is no point of explaining here. You can find all this information on this internet.

What leads to me this?

Whenever I am doing my personal project or in my organisation. I need to organise my images and have to go to manually some compressing site and then convert it into compressed one and replaced. My lead asked me one day why don’t we automate this stuff. I don’t find any good source or anything to automate this. So I thought It’s worth sharing also.

Note: There are already 3 party services which done this for you. But again you have to buy that service. This tutorial is all about automating compression using hooks.

How I did it?

This is the interesting part. Let’s start it. Initially the images size is this:

Before compress

Note: I took this image for demo purpose only

So for automating this stuff I use husky(for git hooks) and lint-staged.

For compression of images i use sharp (it’s open source). If you have this question why this package why not other package there are so many good packages. I totally agree with this. But all this question is already answered sharp. You can check its performance guide. It’s already giving answer to those question.

Code time:

So logic is that before committing to the code check of images and if images find then compress them before committing. You can do other things (like post commit, pre build etc).

Here is complete code:

  "hooks": {
    "pre-commit": "lint-staged"

  A precommit script to compress image before commiting file
  Q: Why Sharp package used?


const fs = require("fs");
const sharp = require("sharp"); //

Function: Update existing file to new compress file
const minifyFile = (filename) => {
  new Promise((resolve, reject) => {
    /*Read upcomimg file*/
    fs.readFile(filename, function (err, sourceData) {
      if (err) throw err;
      /*If file buffer data is present convert it into new compressed file*/
      sharp(sourceData).toFile(filename, (err, info) => {
        err ? reject(err) : resolve();

Fetch images maps from args and compress all.
Compressing is asynchronuous process.
So wait for all image to compress and return.
) /*Find more. here:*/
  .then((x) => x.slice(2))
  .then((x) =>
  .then((x) => Promise.all(x))
  .catch((e) => {

  "name": "image-compression",
  "version": "1.0.0",
  "description": "Pre commit script to compress images",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  "keywords": [],
  "author": {
    "name": "Shubham Verma"
  "license": "ISC",
  "devDependencies": {
    "husky": "^4.2.5",
    "lint-staged": "^10.2.7",
    "sharp": "^0.25.3"
  "lint-staged": {
    "*.{png,jpeg,jpg,gif,svg}": ["node ./compress-image.js"]

I already explained everything in code. Feel free to reach me out.

Last but not least proof ;-)

After compress

That’s all folks. Feel free to ask a question if you find any doubt. The complete code is available on github. Feel free to checkout