Skip to content

Generate page-specific Open Graph previews for docs - #956

Draft
warp-agent-staging[bot] wants to merge 3 commits into
mainfrom
factory/dynamic-og-images
Draft

warp-agent-staging[bot] wants to merge 3 commits into
mainfrom
factory/dynamic-og-images

Conversation

@warp-agent-staging

@warp-agent-staging warp-agent-staging Bot commented Oct 22, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • Replace static social previews with content-hashed 1200×630 PNGs for every rendered docs page, including the standalone API reference.
  • Show only Warp’s logo and the page’s own title; preserve branded typography, safe wrapping, Unicode fonts and the existing default fallback.

Related issues

Original request; no tracked issue.

Validation

  • Typecheck, heading-variable tests, five OG regressions covering title-only content and end-to-end validator fallbacks, full Vercel build and OG output validation passed for all 401 HTML pages.
  • Existing TOC, homepage JSON-LD, Markdown and tracking-route checks passed; Linux/Chromium captures use real production titles, including the longest current title (61 characters).
  • Local crawler-agent HTTP checks passed for Slack, LinkedIn and X; Trunk is unavailable, and live platform unfurls were not tested.

Follow-ups

Previews regenerate during production builds; astro dev retains the default image. Bundled fonts add 20 MB to source, not client downloads.

Screenshots

Computer-use screenshots (10)

PNG 1 (8a04b6d8...) at native 1200×630: "Skills for agents"
PNG 1 (8a04b6d8...) at native 1200×630: "Skills for agents"

PNG 2 (f10d9964...) native size: 3-line title "SQLite and Stripe MCP: basic queries you can make after setup"
PNG 2 (f10d9964...) native size: 3-line title "SQLite and Stripe MCP: basic queries you can make after setup"

PNG 3 (c81b872b...) native size: "Build a Chrome extension (D3.js + JavaScript + HTML + CSS)"
PNG 3 (c81b872b...) native size: "Build a Chrome extension (D3.js + JavaScript + HTML + CSS)"

PNG 4 (25f41ff8...) native size: "GitHub MCP: summarize open PRs and create GitHub issues"
PNG 4 (25f41ff8...) native size: "GitHub MCP: summarize open PRs and create GitHub issues"

PNG 5 (e56bb43e...) native size: "Context7 MCP: update Astro project with best practices"
PNG 5 (e56bb43e...) native size: "Context7 MCP: update Astro project with best practices"

PNG 6 (e05dec70...) native size: "Cloud handoff and orchestration in the Warp Agent CLI"
PNG 6 (e05dec70...) native size: "Cloud handoff and orchestration in the Warp Agent CLI"

PNG 7 (8b72286f...) native size: "Linear MCP: update tickets with a lean build approach"
PNG 7 (8b72286f...) native size: "Linear MCP: update tickets with a lean build approach"

PNG 8 (3102a490...) native size: "Figma remote MCP: create a website from a Figma file"
PNG 8 (3102a490...) native size: "Figma remote MCP: create a website from a Figma file"

PNG 9 (1732db1d...) native size: "Connect developer tools to agents with MCP workflows"
PNG 9 (1732db1d...) native size: "Connect developer tools to agents with MCP workflows"

PNG 10 (1b91b461...) native size: "Warp Platform API reference"
PNG 10 (1b91b461...) native size: "Warp Platform API reference"

@cla-bot cla-bot Bot added the cla-signed label Oct 22, 2026
@vercel

vercel Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Oct 23, 2026 12:17am UTC

Request Review

@warp-agent-staging

Copy link
Copy Markdown
Contributor Author

This PR was generated with Warp.

Comment @warp-staging-factory on this PR to send it follow-up work.

View run View conversation View on Slack

@warp-agent-staging warp-agent-staging Bot added the factory:docs-factory Label associated to the "docs-factory" factory label Oct 22, 2026

This branch was successfully deployed

1 active deployment
Preview — f48eeb6b Deployed Oct 23, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed factory:docs-factory Label associated to the "docs-factory" factory

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants