Skip to content

fix(seo): route-specific OG images per Artemii spec (PILOT-26)#11

Merged
TeoSlayer merged 1 commit into
mainfrom
fix/pilot-26-og-images-153052
May 29, 2026
Merged

fix(seo): route-specific OG images per Artemii spec (PILOT-26)#11
TeoSlayer merged 1 commit into
mainfrom
fix/pilot-26-og-images-153052

Conversation

@TeoSlayer
Copy link
Copy Markdown
Contributor

Per Artemii's comment — each top-level route gets a dedicated 1200×630 OG image.

Wires the routing in BaseHead/DocLayout. JPGs themselves need to be dropped at /public/og/{main,plans,docs,blogs}.jpg (README in that dir explains).

Route OG image
/ /og/main.jpg
/plans /og/plans.jpg
/docs/* /og/docs.jpg (DocLayout default; overridable per page)
/blog/* /og/blogs.jpg (per Artemii's fallback note)

Blast radius: small. Until the JPGs land the og:image URLs 404 — same as today for any page that uses the BaseHead /img/pilot.png default but with the right per-route structure ready. Twitter/Facebook crawlers will fall back to scraping the page itself.

Verification: npm ci && npm run build passes on this branch.

Closes PILOT-26

Per Artemii's comment on PILOT-26, each top-level route gets its own
1200×630 Open Graph image. This PR wires up the routing structure;
the actual JPGs need to be dropped in /public/og/ by hand:

  /            → /og/main.jpg
  /plans       → /og/plans.jpg
  /docs/...    → /og/docs.jpg
  /blog/...    → /og/blogs.jpg (fallback for individual posts too)

Until the JPGs land, the og:image meta tags will 404. The fallback default
in BaseHead.astro stays /img/pilot.png for any page that doesn't override.
public/og/README.md spells out the expected filenames + dimensions.

Changes:
- index.astro: ogImage → /og/main.jpg
- plans.astro: ogImage added → /og/plans.jpg
- blog/index.astro: ogImage added → /og/blogs.jpg
- DocLayout.astro: ogImage prop with /og/docs.jpg default; pass-through
  so individual doc pages can override if needed

BaseHead already emits og:image, twitter:image, twitter:card=summary_large_image.

Closes PILOT-26
@TeoSlayer TeoSlayer force-pushed the fix/pilot-26-og-images-153052 branch from 34ca4d7 to ce45b2c Compare May 29, 2026 15:33
Copy link
Copy Markdown
Contributor

@hank-pilot hank-pilot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving PILOT-26 OG image routing.

@TeoSlayer TeoSlayer merged commit 7804b6f into main May 29, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants