Documentation Image optimization

Image optimization

A proposed workflow for smaller images with predictable dimensions and formats.

Availability

In development — no live transformation API is available.

Image transformation endpoints are in development. This site does not accept images or transform them at request time.

Prepare responsive variants

Generate appropriately sized files during your own build. Prefer a small set of useful sizes, modern formats, and explicit dimensions.

original.png
  → product-640.webp
  → product-1280.webp
  → product-1280.avif

Declare dimensions in HTML

Width and height reserve space before the file arrives. Use responsive sources when a single large image would waste bandwidth on a narrow screen.

<img src="/images/product-640.webp"
  srcset="/images/product-640.webp 640w, /images/product-1280.webp 1280w"
  sizes="(max-width: 640px) 100vw, 640px"
  width="640" height="480"
  alt="Product preview">