Registry / devops / vite-plugin-imagemin

vite-plugin-imagemin

library0.6.1jsnpmunverified

A Vite plugin for compressing image assets (PNG, JPEG, WebP, SVG, GIF) using imagemin. Version 0.6.1 is the current stable, released intermittently. It integrates seamlessly with Vite's build pipeline, offering lossy and lossless compression via configurable imagemin plugins. Key differentiators: supports Vite >=2, provides both lossy and lossless modes, and is actively maintained with TypeScript types included.

devops data

npm install vite-plugin-imagemin

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-IMAGEM

vite-plugin-imagemin

devopsjavascriptv0.6.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

vitePluginImagemin

✓ import vitePluginImagemin from 'vite-plugin-imagemin'

✗ const vitePluginImagemin = require('vite-plugin-imagemin')

Default export; ESM-only since v0.4.0. CommonJS require will fail.

type Options

✓ import type { Options } from 'vite-plugin-imagemin'

✗ import { Options } from 'vite-plugin-imagemin' (if not using type-only import)

Options type is exported for TypeScript users; use type import to avoid runtime side-effects.

VitePluginImagemin

✓ import VitePluginImagemin from 'vite-plugin-imagemin'

✗ import { VitePluginImagemin } from 'vite-plugin-imagemin'

The default export is the plugin function; using named import will result in undefined.

Configures vite-plugin-imagemin in vite.config.ts with compression settings for various image formats.

import { defineConfig } from 'vite'; import vitePluginImagemin from 'vite-plugin-imagemin'; export default defineConfig({ plugins: [ vitePluginImagemin({ gifsicle: { optimizationLevel: 3 }, optipng: { optimizationLevel: 7 }, pngquant: { quality: [0.65, 0.8] }, mozjpeg: { quality: 80 }, svgo: { plugins: [ { name: 'removeViewBox', active: false }, { name: 'removeEmptyAttrs', active: false }, ], }, webp: { quality: 75 }, }), ], });

Debug

Known issues

breakingESM-only since v0.4.0; CommonJS require will throw an error.

fix

Use ES module imports (import).

affects: >=0.4.0

gotchaSome imagemin plugins require native binaries and may fail to install on certain systems.

fix

Ensure build-essential tools are installed; fallback to lossless-only config.

affects: >=0.1.0

gotchaConfiguration keys are optional; if a key is missing, that format is not compressed.

fix

Explicitly configure only the formats you want to compress.

affects: >=0.1.0

deprecatedThe 'imagemin' package was deprecated; this plugin may not receive updates for new imagemin versions.

fix

Consider alternative image optimization plugins (e.g., vite-plugin-image-optimizer).

affects: >=0.6.1

Errors

Common errors & fixes

Error: Cannot find module 'vite-plugin-imagemin'

Package not installed or wrong import path.

fix

Run 'npm install vite-plugin-imagemin --save-dev' and verify import path.

TypeError: Cannot read properties of undefined (reading 'gifsicle')

Missing dependency for the specified compression plugin.

fix

Install the required imagemin plugin, e.g., 'npm install imagemin-gifsicle --save-dev'.

Error: 'default' is not exported by ...

Using CommonJS require with ESM-only package.

fix

Switch to ES module import syntax or downgrade to v0.3.x.

Upgrade

Version history

0.6.1latest on npm

Audit

Dependencies

viterequiredpeer dependency required for plugin to work

Agent activity

19 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/anncwb/vite-plugin-imagemin ↗

packagehttps://www.npmjs.com/package/vite-plugin-imagemin ↗