Files
020d79bb27 [examples] migrate cloudinary to vercel-blob (#93762)
## Summary

Replaces the Cloudinary-backed image gallery example with a Vercel
Blob–backed equivalent. The migration is driven by the broader move of
[`vercel/nextconf-image-gallery`](https://github.com/vercel/nextconf-image-gallery)
(the deployed companion to this example) off Cloudinary.

- Renamed `examples/with-cloudinary` → `examples/with-vercel-blob` via
`git mv` (history preserved).
- Images are discovered at build time via the `@vercel/blob` SDK's
`list()` API, then probed with
[`sharp`](https://github.com/lovell/sharp) for dimensions and to
pre-generate base64 blur placeholders. `next/image` (Vercel's image
optimizer) handles resizing — no Cloudinary `c_scale,w_*` transform
URLs.
- `ImageProps` is now `{ id, url, width, height, blurDataUrl }` (was `{
public_id, format, ... }`).
- `utils/cachedImages.ts` does the listing + dimension probe + blur
placeholder generation.
- Removed `utils/cloudinary.ts` and `utils/generateBlurPlaceholder.ts`.
- `next.config.js` `remotePatterns` now allows
`*.public.blob.vercel-storage.com`.
- Deps: dropped `cloudinary`, `imagemin`, `imagemin-jpegtran`; added
`@vercel/blob` and `sharp`.
- `.env.local.example` reduced to a single `BLOB_READ_WRITE_TOKEN`.
- README rewritten: blob description, deploy-button env, setup steps,
references.

## Test plan

- [x] `npx create-next-app --example with-vercel-blob ./blob-app` clones
cleanly
- [x] After populating a blob store and `.env.local`, `npm run dev`
renders the gallery with blur placeholders
- [x] `npm run build` succeeds (sharp probe + placeholder generation
runs at build time)
- [x] Vercel deploy button flow prompts only for `BLOB_READ_WRITE_TOKEN`

---------

Co-authored-by: Claude Opus 4.7 (1M context) <[email protected]>
Co-authored-by: Joseph <[email protected]>
2026-05-12 11:01:10 +02:00

49 lines
1.3 KiB
TypeScript

import { list } from "@vercel/blob";
import sharp from "sharp";
import type { ImageProps } from "./types";
let cached: ImageProps[] | null = null;
async function fetchBuffer(url: string): Promise<Buffer> {
const res = await fetch(url);
if (!res.ok) throw new Error(`${res.status} fetching ${url}`);
return Buffer.from(await res.arrayBuffer());
}
async function describe(blobUrl: string): Promise<{
width: number;
height: number;
blurDataUrl: string;
}> {
const buf = await fetchBuffer(blobUrl);
const meta = await sharp(buf).metadata();
const placeholder = await sharp(buf)
.resize(10)
.jpeg({ quality: 70 })
.toBuffer();
return {
width: meta.width ?? 0,
height: meta.height ?? 0,
blurDataUrl: `data:image/jpeg;base64,${placeholder.toString("base64")}`,
};
}
export default async function getResults(): Promise<ImageProps[]> {
if (cached) return cached;
const { blobs } = await list();
// Newest-first ordering by pathname (mirrors the original Cloudinary
// `sort_by("public_id", "desc")` behaviour for filenames like
// photo-001.jpg, photo-002.jpg, …).
const sorted = blobs.sort((a, b) => (a.pathname < b.pathname ? 1 : -1));
cached = await Promise.all(
sorted.map(async (blob, id) => ({
id,
url: blob.url,
...(await describe(blob.url)),
})),
);
return cached;
}