Interface: ImageLoaderConfig

Per-storefront configuration the image loader needs to build CDN URLs.

Properties

buildAssetPrefixes?

optional buildAssetPrefixes?: readonly string[]

Framework build-output path prefixes to leave untouched (hashed/immutable assets the framework already fingerprints). Defaults to FRAMEWORK_BUILD_PREFIXES.

---

cdnBase?

optional cdnBase?: string

Override the image CDN base URL. Defaults to IMAGE_CDN_BASE_URL.

---

cleanUrl?

optional cleanUrl?: boolean

Build clean asset URLs without the /s/{shopId} storage namespace. Set for a storefront served from a custom domain ({cdnBase}/_next/static/media/…), where the platform restores the namespace toward storage at the edge so the stored object key is unchanged. Defaults to false — the platform CDN keeps the namespace in the URL ({cdnBase}/s/{shopId}/…). The deploy pipeline sets this from the same provisioning signal that picks the asset host, so the URL form and the storage key can never disagree.

---

shopId

shopId: string

Shop identifier — namespaces this storefront's local images in CDN storage.

---

version

version: string

Current deployment version — busts the cache when a public/ image is replaced under the same name.