Skip to content

πŸ“¦ Compression Image compression plugin based on squoosh and sharp

Notifications You must be signed in to change notification settings

unplugin/unplugin-imagemin

Repository files navigation

πŸ“¦πŸ“¦ unplugin Imagemin Picture compression

NPM version

Important

Tips: 1.0 goals unplugin-imagemin is preparing to release version 1.0, which will be released after achieving the following goals

1. Support all node versions by re-modifying the wasm syntax of squoosh

2. remove sharp deps

3. Supports full cache mode

4. Consider adding query parsing for images in the dev environment

5. Supports rsbuild and farm frameworks

✨✨ Continuous iterative development in testing

✨ : unplugin-imagemin
βœ” : Process start with mode squoosh
βœ… : [test1.png] [12.39 MB] -> [102.54 KB]
βœ” : Process start with mode squoosh
βœ… : [test2.png] [16.38 MB] -> [76.79 KB]

🌈 Features

  • 🍰 Support png jpeg webp avif svg tiff Format
  • 🦾 High Performance based on squoosh
  • ✨ Multiple picture formats can be configured
  • πŸͺ Compress the code at build time
  • πŸ˜ƒ Caching Mechanism Tips: TODO
  • 🌈 You can convert different picture types at build time

Squoosh && Sharp && Svgo

Unplugin-imagemin supports two compression modes

Sharp The typical use case for this high speed Node.js module is to convert large images in common formats to smaller, web-friendly JPEG, PNG, WebP, GIF and AVIF images of varying dimensions.

Squoosh is an image compression web app that reduces image sizes through numerous formats. Squoosh with rust & wasm

Svgo Support compression of pictures in svg format

✨Warning

Although squoosh has done a good job, there will be all kinds of problems in future node versions, so don't use squoosh mode for the time being.

Due to the loading problem of squoosh, unplugin-imagmin currently only supports versions below node 18.

Due to the rapid update of vite version and squoosh stop maintenance and other unstable factors

It is recommended that mode choose sharp.

🍰 Effect display

iShot_2023-09-18_16.41.04.mp4

πŸ“¦ Installation

pnpm add unplugin-imagemin@latest -D

support vite and rollup.

Basic
import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
import imagemin from 'unplugin-imagemin/vite';
// https://vitejs.dev/config/
export default defineConfig({
  plugins: [vue(), imagemin()],
});


Advanced
iimport { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
import imagemin from 'unplugin-imagemin/vite';
import path from 'path';
// https://vitejs.dev/config/
export default defineConfig({
  plugins: [
    vue(),
    imagemin({
      // Default mode sharp. support squoosh and sharp
      mode: 'squoosh',
      beforeBundle: true,
      // Default configuration options for compressing different pictures
      compress: {
        jpg: {
          quality: 10,
        },
        jpeg: {
          quality: 10,
        },
        png: {
          quality: 10,
        },
        webp: {
          quality: 10,
        },
      },
      conversion: [
        { from: 'jpeg', to: 'webp' },
        { from: 'png', to: 'webp' },
        { from: 'JPG', to: 'jpeg' },
      ],
    }),
  ],
});


🌸 DefaultConfiguration

Squoosh DefaultConfiguration and sharp DefaultConfiguration

DefaultConfiguration see DefaultConfiguration

Plugin property configuration see configuration

export interface PluginOptions {
  /**
   * @description Picture compilation and conversion
   * @default []
   */
  conversion?: ConversionItemType[];
  /**
   * @description Whether to turn on caching
   * @default true
   */
  cache?: boolean;
  /**
   * @description Cache folder directory read
   * @default node_modules/unplugin-imagemin/cache
   *
   */
  cacheDir?: string;
  /**
   * @description Compilation attribute
   * @default CompressTypeOptions
   */
  compress?: CompressTypeOptions;
  /**
   * @description mode
   * @default squoosh
   * @description squoosh or sharp
   */
  mode?: 'squoosh' | 'sharp';
  /**
   * @description Whether to compress before packing
   * @default false
   */
  beforeBundle?: boolean;
}

About

πŸ“¦ Compression Image compression plugin based on squoosh and sharp

Resources

Code of conduct

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published