@voila.dev/cliche 0.1.0

package/dist/options.js

@@ -0,0 +1,91 @@
+import { parseArgs } from "node:util";
+export function parseViewport(value) {
+    const match = value.match(/^(\d+)x(\d+)$/);
+    if (match === null) {
+        throw new Error(`Invalid --viewport ${value}: expected <width>x<height>, e.g. 1440x900.`);
+    }
+    return { width: Number(match[1]), height: Number(match[2]) };
+}
+export function parseLocalStorage(entries) {
+    const parsed = {};
+    for (const entry of entries) {
+        const separator = entry.indexOf("=");
+        if (separator < 1) {
+            throw new Error(`Invalid --local-storage ${entry}: expected key=value.`);
+        }
+        parsed[entry.slice(0, separator)] = entry.slice(separator + 1);
+    }
+    return parsed;
+}
+export function parseCommand(argv) {
+    const { values, positionals } = parseArgs({
+        args: [...argv],
+        allowPositionals: true,
+        options: {
+            viewport: { type: "string" },
+            "wait-for": { type: "string" },
+            "scroll-to": { type: "string" },
+            settle: { type: "string" },
+            "local-storage": { type: "string", multiple: true },
+            "full-page": { type: "boolean" },
+            upload: { type: "boolean" },
+            prefix: { type: "string" },
+            markdown: { type: "boolean" },
+            bucket: { type: "string" },
+            port: { type: "string" },
+            help: { type: "boolean", short: "h" },
+        },
+    });
+    if (values.help === true || positionals.length === 0) {
+        return { kind: "help" };
+    }
+    if (positionals[0] === "mcp") {
+        return { kind: "mcp" };
+    }
+    if (positionals[0] === "skill") {
+        return { kind: "skill" };
+    }
+    if (positionals[0] === "setup") {
+        return { kind: "setup", bucket: values.bucket ?? "cliche-shots" };
+    }
+    if (positionals[0] === "album") {
+        const port = values.port === undefined ? undefined : Number(values.port);
+        if (port !== undefined && !Number.isInteger(port)) {
+            throw new Error(`Invalid --port ${values.port}: expected a number.`);
+        }
+        return { kind: "album", port };
+    }
+    if (positionals[0] === "upload") {
+        const files = positionals.slice(1);
+        if (files.length === 0)
+            throw new Error("upload: pass at least one image file.");
+        return { kind: "upload", files, prefix: values.prefix, markdown: values.markdown === true };
+    }
+    const [url, out] = positionals;
+    if (url === undefined || out === undefined) {
+        throw new Error("capture: pass <url> <out.png> (or see --help).");
+    }
+    const settle = values.settle === undefined ? undefined : Number(values.settle);
+    if (settle !== undefined && !Number.isFinite(settle)) {
+        throw new Error(`Invalid --settle ${values.settle}: expected milliseconds.`);
+    }
+    return {
+        kind: "capture",
+        capture: {
+            url,
+            out,
+            ...(values.viewport === undefined ? {} : { viewport: parseViewport(values.viewport) }),
+            ...(values["wait-for"] === undefined ? {} : { waitFor: values["wait-for"] }),
+            ...(values["scroll-to"] === undefined ? {} : { scrollTo: values["scroll-to"] }),
+            ...(settle === undefined ? {} : { settleMilliseconds: settle }),
+            ...(values["local-storage"] === undefined
+                ? {}
+                : { localStorage: parseLocalStorage(values["local-storage"]) }),
+            ...(values["full-page"] === true ? { fullPage: true } : {}),
+        },
+        upload: values.upload === true,
+        prefix: values.prefix,
+        markdown: values.markdown === true,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"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"}

package/dist/setup.d.ts

@@ -0,0 +1,11 @@
+/**
+ * One-command S3 setup on Cloudflare R2, riding the user's `wrangler login`
+ * session: create the bucket, enable its managed public r2.dev URL, and
+ * write the resulting configuration to `.env`. The only step wrangler cannot
+ * do is minting S3 API keys — the dashboard link for that is printed (and
+ * left as a comment in `.env`).
+ */
+export declare function parseAccountId(whoamiOutput: string): string | null;
+export declare function parsePublicUrl(devUrlOutput: string): string | null;
+export declare function setup(bucket: string): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIlE;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAElE;AAuBD,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CzD"}

package/dist/setup.js

@@ -0,0 +1,85 @@
+/**
+ * One-command S3 setup on Cloudflare R2, riding the user's `wrangler login`
+ * session: create the bucket, enable its managed public r2.dev URL, and
+ * write the resulting configuration to `.env`. The only step wrangler cannot
+ * do is minting S3 API keys — the dashboard link for that is printed (and
+ * left as a comment in `.env`).
+ */
+const DASHBOARD_TOKENS_URL = "https://dash.cloudflare.com/?to=/:account/r2/api-tokens";
+async function wrangler(args, options = {}) {
+    const subprocess = Bun.spawn(["bunx", "wrangler", ...args], {
+        stdin: "inherit",
+        stdout: options.interactive === true ? "inherit" : "pipe",
+        stderr: options.interactive === true ? "inherit" : "pipe",
+    });
+    const exitCode = await subprocess.exited;
+    const output = options.interactive === true
+        ? ""
+        : (await new Response(subprocess.stdout).text()) +
+            (await new Response(subprocess.stderr).text());
+    return { exitCode, output };
+}
+export function parseAccountId(whoamiOutput) {
+    // `wrangler whoami` prints an account table; a lone account is unambiguous.
+    const ids = [...new Set(whoamiOutput.match(/\b[0-9a-f]{32}\b/g) ?? [])];
+    return ids.length === 1 ? (ids[0] ?? null) : null;
+}
+export function parsePublicUrl(devUrlOutput) {
+    return devUrlOutput.match(/https:\/\/[a-z0-9-]+\.r2\.dev/)?.[0] ?? null;
+}
+function environmentBlock(bucket, publicUrl, accountId) {
+    const lines = [
+        "",
+        "# cliche — added by `cliche setup` (https://cliche.voila.dev)",
+        `S3_BUCKET=${bucket}`,
+        accountId === null
+            ? "# S3_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com"
+            : `S3_ENDPOINT=https://${accountId}.r2.cloudflarestorage.com`,
+        ...(publicUrl === null ? [] : [`CLICHE_PUBLIC_URL=${publicUrl}`]),
+        `# Mint the two keys at ${DASHBOARD_TOKENS_URL} (Object Read & Write on ${bucket}):`,
+        "# S3_ACCESS_KEY_ID=",
+        "# S3_SECRET_ACCESS_KEY=",
+        "",
+    ];
+    return lines.join("\n");
+}
+export async function setup(bucket) {
+    console.error(`Setting up Cloudflare R2 bucket "${bucket}" via wrangler…`);
+    const whoami = await wrangler(["whoami"]);
+    if (whoami.exitCode !== 0 || whoami.output.includes("You are not authenticated")) {
+        throw new Error("wrangler is not logged in — run `bunx wrangler login` first.");
+    }
+    const accountId = parseAccountId(whoami.output);
+    if (accountId === null) {
+        console.error("Several Cloudflare accounts found: wrangler will ask which one to use (set CLOUDFLARE_ACCOUNT_ID to skip the prompt).");
+    }
+    const create = await wrangler(["r2", "bucket", "create", bucket], { interactive: true });
+    if (create.exitCode !== 0) {
+        // Most likely the bucket already exists, which is fine for reruns; the
+        // dev-url step below fails loudly if the bucket truly is not there.
+        console.error(`(bucket create exited ${create.exitCode} — continuing, it probably already exists)`);
+    }
+    console.error("Enabling the managed public r2.dev URL…");
+    await wrangler(["r2", "bucket", "dev-url", "enable", bucket, "--force"], { interactive: true });
+    const devUrl = await wrangler(["r2", "bucket", "dev-url", "get", bucket]);
+    const publicUrl = parsePublicUrl(devUrl.output);
+    const environmentFile = Bun.file(".env");
+    const existing = (await environmentFile.exists()) ? await environmentFile.text() : "";
+    if (existing.includes("S3_BUCKET=")) {
+        console.error(".env already has an S3_BUCKET — printing the block instead of appending:");
+        console.log(environmentBlock(bucket, publicUrl, accountId));
+    }
+    else {
+        await Bun.write(".env", existing + environmentBlock(bucket, publicUrl, accountId));
+        console.error("Wrote the configuration to .env.");
+    }
+    console.error(`
+Almost there — one last step wrangler cannot do:
+  1. Open ${DASHBOARD_TOKENS_URL}
+  2. Create an API token with "Object Read & Write" on "${bucket}"
+  3. Put the two values in .env as S3_ACCESS_KEY_ID / S3_SECRET_ACCESS_KEY
+
+Then take your first cliché:
+  bunx @voila.dev/cliche https://example.com shot.png --upload`);
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}

package/dist/skill.d.ts

@@ -0,0 +1,8 @@
+export declare const SKILL_TARGET = ".claude/skills/pr-screenshots/SKILL.md";
+/**
+ * Install the packaged PR-screenshots skill into the current repository.
+ * The skill ships with the package (`skill/SKILL.md`), so this works offline
+ * and always matches the installed cliche version.
+ */
+export declare function installSkill(): Promise<string>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY,2CAA2C,CAAC;AAErE;;;;GAIG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAIpD"}

package/dist/skill.js

@@ -0,0 +1,13 @@
+import { fileURLToPath } from "node:url";
+export const SKILL_TARGET = ".claude/skills/pr-screenshots/SKILL.md";
+/**
+ * Install the packaged PR-screenshots skill into the current repository.
+ * The skill ships with the package (`skill/SKILL.md`), so this works offline
+ * and always matches the installed cliche version.
+ */
+export async function installSkill() {
+    const source = fileURLToPath(new URL("../skill/SKILL.md", import.meta.url));
+    await Bun.write(SKILL_TARGET, Bun.file(source));
+    return SKILL_TARGET;
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,YAAY,GAAG,wCAAwC,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5E,MAAM,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAChD,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/upload.d.ts

@@ -0,0 +1,27 @@
+export interface UploadOptions {
+    readonly files: ReadonlyArray<string>;
+    /** Object key prefix, e.g. `pr-123`. Defaults to `cliche`. */
+    readonly prefix?: string;
+}
+export interface UploadedFile {
+    readonly file: string;
+    readonly key: string;
+    readonly url: string;
+    /** A ready-to-paste `![caption](url)` line. */
+    readonly markdown: string;
+}
+/** The subset of Bun.S3Client the upload needs; injectable for tests. */
+export interface ObjectWriter {
+    write(key: string, bytes: Uint8Array, options: {
+        type: string;
+    }): Promise<unknown>;
+}
+export declare function publicBaseUrl(): string;
+/**
+ * Upload images to the S3-compatible bucket described by the standard
+ * environment variables Bun.S3Client already reads (S3_* / AWS_*), and
+ * return one markdown line per file. `CLICHE_PUBLIC_URL` overrides the
+ * public base URL (custom domains, R2 public buckets).
+ */
+export declare function upload(options: UploadOptions, writer?: ObjectWriter): Promise<Array<UploadedFile>>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AAED,wBAAgB,aAAa,IAAI,MAAM,CAatC;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAoBxG"}

package/dist/upload.js

@@ -0,0 +1,51 @@
+import { extname } from "node:path";
+import { captionOf, objectKeyOf } from "./keys.js";
+const CONTENT_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".gif": "image/gif",
+};
+export function publicBaseUrl() {
+    const configured = process.env.CLICHE_PUBLIC_URL;
+    if (configured !== undefined)
+        return configured.replace(/\/$/, "");
+    const bucket = process.env.S3_BUCKET ?? process.env.AWS_BUCKET;
+    if (bucket === undefined) {
+        throw new Error("No bucket configured: set S3_BUCKET (and S3_ENDPOINT + S3_ACCESS_KEY_ID + S3_SECRET_ACCESS_KEY), or CLICHE_PUBLIC_URL alone if the bucket is resolved elsewhere.");
+    }
+    const endpoint = process.env.S3_ENDPOINT ?? process.env.AWS_ENDPOINT;
+    if (endpoint !== undefined)
+        return `${endpoint.replace(/\/$/, "")}/${bucket}`;
+    const region = process.env.AWS_REGION ?? process.env.S3_REGION ?? "us-east-1";
+    return `https://${bucket}.s3.${region}.amazonaws.com`;
+}
+/**
+ * Upload images to the S3-compatible bucket described by the standard
+ * environment variables Bun.S3Client already reads (S3_* / AWS_*), and
+ * return one markdown line per file. `CLICHE_PUBLIC_URL` overrides the
+ * public base URL (custom domains, R2 public buckets).
+ */
+export async function upload(options, writer) {
+    const baseUrl = publicBaseUrl();
+    const client = writer ?? new Bun.S3Client();
+    const prefix = options.prefix ?? "cliche";
+    const date = new Date().toISOString().slice(0, 10);
+    const uploaded = [];
+    for (const file of options.files) {
+        const contentType = CONTENT_TYPES[extname(file).toLowerCase()];
+        if (contentType === undefined) {
+            console.error(`Skipping ${file}: unsupported extension`);
+            continue;
+        }
+        const bytes = await Bun.file(file).bytes();
+        const key = objectKeyOf(prefix, file, bytes, date);
+        await client.write(key, bytes, { type: contentType });
+        console.error(`Uploaded ${file} -> ${key}`);
+        const url = `${baseUrl}/${key}`;
+        uploaded.push({ file, key, url, markdown: `![${captionOf(file)}](${url})` });
+    }
+    return uploaded;
+}
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../src/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,aAAa,GAA2B;IAC5C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;CACpB,CAAC;AAqBF,MAAM,UAAU,aAAa;IAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACjD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IAC/D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,kKAAkK,CACnK,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC;IAC9E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,WAAW,CAAC;IAC9E,OAAO,WAAW,MAAM,OAAO,MAAM,gBAAgB,CAAC;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAAsB,EAAE,MAAqB;IACxE,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,IAAI,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,QAAQ,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/D,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,yBAAyB,CAAC,CAAC;YACzD,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACnD,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,OAAO,GAAG,EAAE,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,GAAG,OAAO,IAAI,GAAG,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,SAAS,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@voila.dev/cliche",
+  "version": "0.1.0",
+  "type": "module",
+  "packageManager": "bun@1.4.0",
+  "license": "MIT",
+  "description": "Take a cliché of any page and get a shareable URL — screenshots with Bun.WebView, uploads with Bun.S3Client, zero dependencies.",
+  "homepage": "https://github.com/voila-voila-dev/cliche",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voila-voila-dev/cliche.git"
+  },
+  "bugs": {
+    "url": "https://github.com/voila-voila-dev/cliche/issues"
+  },
+  "keywords": [
+    "screenshot",
+    "bun",
+    "webview",
+    "s3",
+    "r2",
+    "pull-request",
+    "cli"
+  ],
+  "sideEffects": [],
+  "bin": {
+    "cliche": "./dist/cli.js"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "skill",
+    "apps/album/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "bun": ">=1.4.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc -p tsconfig.json",
+    "test": "bun test",
+    "ci": "bun run check && bun run build && bun test"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.0",
+    "typescript": "^5.9.3"
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: pr-screenshots
+description: Capture before/after screenshots of UI changes with @voila.dev/cliche and embed them in the pull request. Use whenever a PR touches something user-visible, right before opening or updating the PR. Also on request.
+---
+
+# PR screenshots
+
+A PR that changes what users see should show it. Capture the changed screens
+with `cliche`, upload them, and embed the markdown in the PR body.
+
+## When (and when not)
+
+- Any PR whose diff changes rendered UI: screens, components, layout, states,
+  copy with visual impact. Skip for pure logic/backend/refactor PRs where
+  pixels are provably identical.
+- Capture **after** shots always. Add **before** shots (production or a
+  deployed preview) only when the change modifies an existing screen: the
+  pair is what makes a redesign reviewable.
+
+## 1. Capture
+
+Run the branch locally, then:
+
+```sh
+bunx @voila.dev/cliche http://localhost:3000/changed-screen \
+  qa-screenshots/changed-screen-after.png \
+  --wait-for '[data-testid=changed-screen]'
+```
+
+- `--local-storage <key>=<token>` seeds a session token for authenticated
+  screens; `--scroll-to <css>` reaches below-the-fold components;
+  `--viewport 390x844` for responsive changes (default is 1440x900);
+  `--full-page` when the whole screen changed.
+- Use demo/seed data only. Never real user data: the bucket is public.
+- Name files as captions: `mission-detail-after.png` reads as
+  "mission detail after".
+- Keep it curated: at most ~8 images per PR, one per meaningfully distinct
+  screen/state.
+
+## 2. Upload
+
+```sh
+bunx @voila.dev/cliche upload --prefix pr-<number> --markdown qa-screenshots/*.png
+```
+
+Prints one `![caption](url)` line per file on stdout (without `--markdown`,
+bare URLs). Bucket configuration
+comes from the standard `S3_*` environment variables plus
+`CLICHE_PUBLIC_URL` (see the package README).
+
+## 3. Embed in the PR
+
+Add a `## Screenshots` section to the PR body (`gh pr edit <n> --body ...`):
+
+```markdown
+## Screenshots
+
+| Before | After |
+| --- | --- |
+| ![mission detail before](url) | ![mission detail after](url) |
+```
+
+After-only shots go as plain images with a one-line caption above each. When
+updating after review changes: re-capture, re-upload (keys are
+content-hashed, old links keep working), replace the section.

package/src/capture.ts

@@ -0,0 +1,85 @@
+const WAIT_FOR_TIMEOUT_MILLISECONDS = 15_000;
+const WAIT_FOR_POLL_MILLISECONDS = 250;
+
+export interface Viewport {
+  readonly width: number;
+  readonly height: number;
+}
+
+export interface CaptureOptions {
+  /** The page to screenshot. */
+  readonly url: string;
+  /** Where to write the PNG. */
+  readonly out: string;
+  /** Defaults to 1440×900. */
+  readonly viewport?: Viewport;
+  /**
+   * Entries seeded into the target origin's localStorage before the page
+   * loads — the way in for apps that keep their session token there.
+   */
+  readonly localStorage?: Readonly<Record<string, string>>;
+  /** CSS selector to wait for before shooting (15s timeout). */
+  readonly waitFor?: string;
+  /** CSS selector scrolled into view before shooting. */
+  readonly scrollTo?: string;
+  /** Milliseconds to let the page settle after load. Defaults to 1500. */
+  readonly settleMilliseconds?: number;
+  /** Grow the viewport to the full page height before shooting. */
+  readonly fullPage?: boolean;
+}
+
+// Bun.WebView rejects viewport dimensions above 16384 pixels.
+const MAXIMUM_VIEWPORT_HEIGHT = 16_384;
+
+function sleep(milliseconds: number): Promise<void> {
+  return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+
+async function waitForSelector(view: Bun.WebView, selector: string): Promise<void> {
+  const deadline = Date.now() + WAIT_FOR_TIMEOUT_MILLISECONDS;
+  const probe = `!!document.querySelector(${JSON.stringify(selector)})`;
+  while (!(await view.evaluate<boolean>(probe))) {
+    if (Date.now() > deadline) {
+      throw new Error(`Timed out after ${WAIT_FOR_TIMEOUT_MILLISECONDS}ms waiting for ${selector}`);
+    }
+    await sleep(WAIT_FOR_POLL_MILLISECONDS);
+  }
+}
+
+/** Screenshot a page with Bun.WebView and write it to `options.out` as PNG. */
+export async function capture(options: CaptureOptions): Promise<void> {
+  const viewport = options.viewport ?? { width: 1440, height: 900 };
+  await using view = new Bun.WebView(viewport);
+  const localStorageEntries = Object.entries(options.localStorage ?? {});
+  if (localStorageEntries.length > 0) {
+    // localStorage is origin-scoped, so land on the origin (any page, a login
+    // redirect is fine) to seed the entries before loading the target.
+    await view.navigate(new URL(options.url).origin);
+    for (const [key, value] of localStorageEntries) {
+      await view.evaluate(
+        `localStorage.setItem(${JSON.stringify(key)}, ${JSON.stringify(value)})`,
+      );
+    }
+  }
+  await view.navigate(options.url);
+  if (options.waitFor !== undefined) {
+    await waitForSelector(view, options.waitFor);
+  }
+  // A fixed delay for fonts, images and entrance animations: dev servers keep
+  // an HMR socket open, so there is no network-idle moment to wait for.
+  await sleep(options.settleMilliseconds ?? 1500);
+  if (options.fullPage === true) {
+    const pageHeight = await view.evaluate<number>(
+      "Math.max(document.documentElement.scrollHeight, document.body.scrollHeight)",
+    );
+    if (pageHeight > viewport.height) {
+      await view.resize(viewport.width, Math.min(pageHeight, MAXIMUM_VIEWPORT_HEIGHT));
+      await sleep(400);
+    }
+  }
+  if (options.scrollTo !== undefined) {
+    await view.scrollTo(options.scrollTo);
+    await sleep(300);
+  }
+  await Bun.write(options.out, await view.screenshot());
+}

package/src/cli.ts

@@ -0,0 +1,101 @@
+#!/usr/bin/env bun
+import { capture } from "./capture.ts";
+import { runMcpServer } from "./mcp.ts";
+import { parseCommand } from "./options.ts";
+import { setup } from "./setup.ts";
+import { installSkill } from "./skill.ts";
+import { upload, type UploadedFile } from "./upload.ts";
+
+const HELP = `cliche — take a cliché of any page and get a shareable URL.
+
+Usage:
+  cliche <url> <out.png> [options]        Screenshot a page.
+  cliche <url> <out.png> --upload         …and upload it, printing its URL.
+  cliche upload [--prefix pr-123] <files> Upload images, printing their URLs.
+  cliche mcp                              Serve the tools over MCP (stdio).
+  cliche setup [--bucket name]            Create an R2 bucket via wrangler and
+                                          write the S3 config to .env.
+  cliche album [--port 4949]              Browse the bucket as a photo album.
+  cliche skill                            Install the PR-screenshots skill into
+                                          .claude/skills/ (Claude Code).
+
+Capture options:
+  --viewport <WxH>            Viewport, default 1440x900 (390x844 for mobile).
+  --wait-for <css>            Wait for a selector before shooting (15s max).
+  --scroll-to <css>           Scroll a selector into view before shooting.
+  --settle <ms>               Let the page settle after load, default 1500.
+  --full-page                 Grow the viewport to the full page height.
+  --local-storage key=value   Seed localStorage on the target origin
+                              (repeatable; e.g. a session token).
+
+Upload options:
+  --prefix <name>             Object key prefix, e.g. pr-123.
+  --markdown                  Print ![caption](url) lines instead of URLs.
+
+Upload configuration (standard Bun.S3Client environment variables):
+  S3_BUCKET, S3_ENDPOINT, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY (or AWS_*)
+  CLICHE_PUBLIC_URL           Public base URL of the bucket (custom domain).
+
+URLs go to stdout, progress to stderr. Ouistiti !`;
+
+function printUploads(uploaded: ReadonlyArray<UploadedFile>, markdown: boolean): void {
+  console.log(uploaded.map((entry) => (markdown ? entry.markdown : entry.url)).join("\n"));
+}
+
+async function main(): Promise<void> {
+  const command = parseCommand(Bun.argv.slice(2));
+  switch (command.kind) {
+    case "help":
+      console.log(HELP);
+      return;
+    case "mcp":
+      await runMcpServer();
+      return;
+    case "skill": {
+      const target = await installSkill();
+      console.error(`Installed the PR-screenshots skill at ${target}`);
+      return;
+    }
+    case "setup":
+      await setup(command.bucket);
+      return;
+    case "album": {
+      if (command.port !== undefined) process.env.PORT = String(command.port);
+      // Dynamic with a computed specifier so tsc ships it untouched: the album
+      // is TS + HTML imports that Bun resolves at runtime from the package.
+      const albumEntry = "../apps/album/src/index.ts";
+      await import(albumEntry);
+      const url = `http://localhost:${process.env.PORT ?? 4949}`;
+      const opener = process.platform === "darwin" ? "open" : "xdg-open";
+      Bun.spawn([opener, url], { stdout: "ignore", stderr: "ignore" });
+      // Keep the process alive for the server.
+      await new Promise(() => {});
+      return;
+    }
+    case "upload": {
+      const uploaded = await upload({
+        files: command.files,
+        ...(command.prefix === undefined ? {} : { prefix: command.prefix }),
+      });
+      printUploads(uploaded, command.markdown);
+      return;
+    }
+    case "capture": {
+      await capture(command.capture);
+      console.error(`Captured ${command.capture.url} -> ${command.capture.out}`);
+      if (command.upload) {
+        const uploaded = await upload({
+          files: [command.capture.out],
+          ...(command.prefix === undefined ? {} : { prefix: command.prefix }),
+        });
+        printUploads(uploaded, command.markdown);
+      }
+      return;
+    }
+  }
+}
+
+main().catch((error: unknown) => {
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});

package/src/index.ts

@@ -0,0 +1,7 @@
+export { capture } from "./capture.ts";
+export type { CaptureOptions, Viewport } from "./capture.ts";
+export { upload } from "./upload.ts";
+export type { ObjectWriter, UploadedFile, UploadOptions } from "./upload.ts";
+export { captionOf, objectKeyOf, slugOf } from "./keys.ts";
+export { handleMessage, runMcpServer } from "./mcp.ts";
+export type { McpDependencies } from "./mcp.ts";