@betttercms/image-url

@betttercms/image-url

Chainable, immutable builder for optimized BetterCMS image URLs — the @sanity/image-url of BetterCMS. Zero runtime dependencies; assembles URLs against the media transform endpoint (GET /media/:id?w&h&format&quality&fit&dpr).

Install

npm install @betttercms/image-url

Usage

import imageUrlBuilder from "@betttercms/image-url";

const urlFor = imageUrlBuilder({ baseUrl: "https://media.bettercms.ai" });

// From an asset id, a MediaAsset object, or an existing media URL:
urlFor(asset).width(800).format("webp").quality(80).url();
// → https://media.bettercms.ai/media/<id>?w=800&format=webp&quality=80

One-shot helper:

import { imageUrl } from "@betttercms/image-url";
imageUrl(asset).size(400, 300).fit("cover").dpr(2).url();

Builder methods

baseUrl defaults to https://media.bettercms.ai. Every method returns a new builder, so chains are safe to fork.