pilot-protocol · TeoSlayer · May 29, 2026 · May 29, 2026
diff --git a/public/og/README.md b/public/og/README.md
@@ -0,0 +1,12 @@
+# Open Graph images
+
+Per Artemii's spec on [PILOT-26](https://vulturelabs.atlassian.net/browse/PILOT-26), drop the following JPGs in this directory and the meta tags wired in this PR will pick them up automatically:
+
+- `main.jpg`  → used by `/` (src/pages/index.astro)
+- `plans.jpg` → used by `/plans` (src/pages/plans.astro)
+- `docs.jpg`  → used by `/docs/` and all docs sub-routes (src/pages/docs/index.astro + layout)
+- `blogs.jpg` → used by `/blog/` index AND every individual blog post (fallback per Artemii's note)
+
+Recommended dimensions: **1200 × 630 px** (Open Graph standard for `summary_large_image`).
+
+Until the JPGs land, the meta tags will 404 — but the fallback default in `BaseHead.astro` remains `/img/pilot.png` for any page that doesn't override ogImage.
diff --git a/src/layouts/DocLayout.astro b/src/layouts/DocLayout.astro
@@ -16,9 +16,10 @@ interface Props {
   prev?: { label: string; href: string };
   next?: { label: string; href: string };
   hidePageNav?: boolean;
+  ogImage?: string;
 }
 
-const { title, description, activePage, canonicalPath, prev, next, hidePageNav } = Astro.props;
+const { title, description, activePage, canonicalPath, prev, next, hidePageNav , ogImage } = Astro.props;
 const canonicalUrl = canonicalPath ? `https://pilotprotocol.network${canonicalPath}` : undefined;
 
 const breadcrumbItems = [
@@ -32,7 +33,7 @@ if (activePage !== 'index') {
 <!DOCTYPE html>
 <html lang="en">
 <head>
-  <BaseHead title={title} description={description} canonicalUrl={canonicalUrl} />
+  <BaseHead title={title} description={description} canonicalUrl={canonicalUrl} ogImage={ogImage ?? "https://pilotprotocol.network/og/docs.jpg"} />
   <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css" />
   <script type="application/ld+json" set:html={JSON.stringify({
     "@context": "https://schema.org",

diff --git a/src/pages/blog/index.astro b/src/pages/blog/index.astro
@@ -11,7 +11,7 @@ const filterCategories = ['All', ...categories];
 <!DOCTYPE html>
 <html lang="en">
 <head>
-  <BaseHead title="Blog - Pilot Protocol" description="Technical articles on AI agent networking, P2P infrastructure, NAT traversal, trust models, and building with Pilot Protocol." canonicalUrl="https://pilotprotocol.network/blog/" />
+  <BaseHead title="Blog - Pilot Protocol" description="Technical articles on AI agent networking, P2P infrastructure, NAT traversal, trust models, and building with Pilot Protocol." canonicalUrl="https://pilotprotocol.network/blog/" ogImage="https://pilotprotocol.network/og/blogs.jpg" />
   <script type="application/ld+json" set:html={JSON.stringify({
     "@context": "https://schema.org",
     "@type": "CollectionPage",

diff --git a/src/pages/index.astro b/src/pages/index.astro
@@ -68,7 +68,7 @@ try {
   title="Pilot Protocol - The internet for agents"
   description="Pilot is the network layer for AI agents. Peer-to-peer encrypted tunnels at the UDP layer. One line of code. No central dependency."
   canonicalUrl="https://pilotprotocol.network/"
-  ogImage="https://pilotprotocol.network/img/pilot.png"
+  ogImage="https://pilotprotocol.network/og/main.jpg"
 />
 </head>
 <body>

diff --git a/src/pages/plans.astro b/src/pages/plans.astro
@@ -11,7 +11,7 @@ const canonicalUrl = "https://pilotprotocol.network/plans";
 <!DOCTYPE html>
 <html lang="en">
 <head>
-<BaseHead title={title} description={description} canonicalUrl={canonicalUrl} />
+<BaseHead title={title} description={description} canonicalUrl={canonicalUrl} ogImage="https://pilotprotocol.network/og/plans.jpg" />
 <script type="application/ld+json" set:html={JSON.stringify({
   "@context": "https://schema.org",
   "@type": "WebPage",