[arjunpredev]

Every docs page link now unfurls with the one pre.dev share card, showing that page's section, title and description.

How cards are made

• site/lib/share-card.mjs is an exact copy of the card spec (header kept). site/lib/share-card.d.mts types it.
• site/lib/og-card.ts builds each page's card:
  • eyebrow pre.dev · Docs · <section>
  • title (fit: true)
  • the page description
  • footer pre.dev documentation and docs.pre.dev/<page>
• site/app/og/[...slug]/route.ts draws the cards at build time with satori 0.33.4 and @resvg/resvg-js 2.6.2, both added as devDependencies. These are the versions the spec was verified with. fitCard measures with that same satori. The route replaces the next/og ImageResponse card, which bundles satori 0.25 and gives no satori to measure with. A card that fails checkCard() stops the build.
• Section: the page's group in docs.json, at most two levels below its tab. The AI Gateway endpoint pages read "AI Gateway reference" and the payments pages read "Payments". A section too long for the eyebrow line fails the build.
• No description: the page's first paragraph is used. Today every page has a description, and npm run check already requires one.

Cache busting

• Cards live at /og/<page>/<hash>.png. The hash is the first 10 hex characters of the sha256 of CARD_DESIGN plus the card's inputs.
• When a title, description, section, address or design changes, the card gets a new URL, and the page's og:image and twitter:image point at it.
• The Worker serves hashed cards with max-age=31536000, immutable.
• /og/<page>/image.png, the old address, still answers with the current card, so earlier unfurls keep their image.

Tags on every page

og:image (+ :type, :width 1200, :height 630, :alt), twitter:card summary_large_image, twitter:image (+ :alt), og:site_name pre.dev, and og:title set to the page title alone. Both alt tags are cardAlt(card).

CI gate

npm run check:out (the "Docs site" workflow) now fails any nav page when:

• its og:image is missing, or is not /og/<page>/<hash>.png
• the PNG is missing from the build, or is not 1200x630
• either alt tag is missing, the two differ, or the alt runs past 420 characters
• twitter:card is not summary_large_image, or twitter:image differs from og:image
• og:site_name is wrong, or og:title is more than the page title

Checked locally

• npm run check: passed, 103 pages.
• npm run build: 103 share cards. check:out: 103 pages, 103 share cards, 79 redirects, 1350 internal links OK.
• check:worker: passed. tsc --noEmit: passed.
• parity.mjs through wrangler dev: 404 URL checks, no differences.
• The coding-agent/memory card is byte-identical to the approved reference render.
• Negative test: removing one page's card PNG and another page's alt tags made check:out fail on both.

🤖 Generated with Claude Code