Skip to content

derivatives-sharp

Registers an image/* renderer against the derivativeRenderer extension point declared by file-derivatives, backed by sharp. Supports resize/fit (cover, inside, contain), format conversion with quality (webp, avif, jpeg), whole-image blur, and blurring individual regions burned in before resize (see BlurRegion). EXIF orientation is applied and then normalized away, and all other EXIF (including GPS) is dropped. Server-only: sharp is a native binding — never import this from client code.

What this feature needs to run (Requires).

flowchart TB
  n_derivatives_sharp["derivatives-sharp"]
  subgraph how_reqs["Requires"]
    n_file_derivatives["file-derivatives"]
  end
  n_file_derivatives --> n_derivatives_sharp
  • Registers extension: derivativeRendererimage/*