Introduction
What zudo-image-tweaker is and how its eleven subpath modules are organized.
What is zudo-image-tweaker?
@takazudo/zudo-image-tweaker is a sharp-based image-tweaking toolkit, published as eleven focused subpath modules rather than one flat API. Each module is its own exports entry, so a consumer only pulls in the code paths — and the optional/native dependencies — that the modules they actually import need.
The eleven modules
| Subpath | What it does |
|---|---|
/ | Multi-width WebP variant engine: content-hash cache, corruption repair, filename-tag dispatch. |
/ | HEIC/HEIF → JPEG conversion with ICC profile preservation. |
/ | Social-card (Open Graph / Twitter card) image compositor. |
/ | Byte-budget encode ladder — search for the highest quality that still fits a byte cap. |
/ | Five-mode square-crop toolbox. |
/ | ML background removal plus procedural shadow synthesis for product photography. |
/ | Background color normalization toward a target color. |
/ | Overlay batch compositing. |
/ | BlurHash placeholder generation. |
/ | EXIF metadata extraction and orientation helpers. |
/ | Client-side upload preparation pipeline. |
Every module is reachable both as a dedicated subpath (@takazudo/) and, for most exports, from the flat root import (@takazudo/zudo-image-tweaker) — see Installation for both forms.
Where to go next
Installation — add the package and handle the sharp build-script prompt.
Quick Start — process a directory of source photos into responsive variants.
Configuration — the full
/engine config surface.variants