Registry / devops / vite-plugin-minipic

vite-plugin-minipic

library1.3.2jsnpmunverified

vite-plugin-minipic (v1.3.2) is a build-time image compression plugin for Vite projects, leveraging sharp.js for fast compression (e.g., 40MB images in ~3s, 70-80% reduction). It includes disk caching to avoid re-compression, supports format conversion (e.g., PNG to WebP), and handles public folder images. Unlike imagemin-based plugins, minipic offers higher speed and optional cache control. Requires Node.js and sharp native binding; install issues common on Windows or with mismatched Node versions. Ships TypeScript types and is updated irregularly.

devops http-networking

npm install vite-plugin-minipic

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-MINIPI

vite-plugin-minipic

devopsjavascriptv1.3.2

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.

minipic

✓ import minipic from 'vite-plugin-minipic'

✗ import { minipic } from 'vite-plugin-minipic'

Default export only. Named import will fail.

MinipicOptions

✓ import type { MinipicOptions } from 'vite-plugin-minipic'

✗ import { MinipicOptions } from 'vite-plugin-minipic'

Type import for TypeScript projects; cannot be used as value.

minipic (CommonJS)

✓ const minipic = require('vite-plugin-minipic')

✗ const { minipic } = require('vite-plugin-minipic')

CommonJS defaults to default export via module.exports.

Configures vite-plugin-minipic with sharp quality options, format conversion, and cache enabled.

import minipic from 'vite-plugin-minipic' import { defineConfig } from 'vite' export default defineConfig({ plugins: [ minipic({ sharpOptions: { png: { quality: 70 }, jpeg: { quality: 70 }, webp: { quality: 75 } }, convert: [ { from: 'png', to: 'webp' }, { from: 'jpeg', to: 'jpg' } ], cache: true, exclude: [], include: ['**/*.{png,jpg,jpeg,webp}'] }) ] })

Debug

Known issues

breakingvite-plugin-minipic requires Vite >=3.x; may not work with Vite 2.

fix

Upgrade Vite to version 3 or later.

affects: >=1.0 <2.0

gotchasharp native binary installation fails on some environments (e.g., Windows missing build tools).

fix

Set .npmrc: sharp_binary_host=https://registry.npmmirror.com/-/binary/sharp and run npm install.

affects: >=1.0

deprecatedThe 'convertPublic' option has been deprecated since v1.1.0.

fix

Use 'convert' option with include/exclude patterns instead.

affects: >=1.1.0

gotchaCache is stored in node_modules/.cache/minipic; clearing node_modules will delete cache.

fix

Use persistent cache location via environment variables or avoid full node_modules deletion.

affects: >=1.0

breakingIn v1.2.0, the default value for 'cache' changed from false to true.

fix

Set cache: false explicitly if you want to disable caching.

affects: ~1.2.0

Errors

Common errors & fixes

Error: Cannot find module 'sharp'

Missing or failed installation of sharp native binary.

fix

Reinstall: npm install sharp@latest; if fails, follow install instructions with npmmirror registry.

Error [ERR_REQUIRE_ESM]: require() of ES Module .../vite-plugin-minipic/dist/index.mjs from ... not supported.

Trying to use the plugin with CommonJS require() in a Node.js version that doesn't support ESM.

fix

Use dynamic import: const minipic = (await import('vite-plugin-minipic')).default; or use ESM config file.

TypeError: minipic is not a function

Using named import instead of default import in ESM.

fix

import minipic from 'vite-plugin-minipic' (not { minipic }).

Upgrade

Version history

1.3.2latest on npm

Audit

Dependencies

sharprequiredCore image compression engine; native dependency.

viterequiredPeer dependency; plugin runs only within Vite.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/60late/vite-plugin-minipic ↗

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