Updating frontmatter for SEO

Author: alex72508

src/content.config.ts

@@ -10,7 +10,12 @@ export const collections = {
         page_id: z.string().uuid(),
         relatedArticles: z.string().array().optional().nullable(),
         app_context: z.array(z.any()).optional(),
-        social_sharing_image_url: z.string().optional()
+        social_sharing_image_url: z.string().optional(),
+        audience: z.union([z.string(), z.array(z.string())]).optional(),
+        complexity: z.string().optional(),
+        keywords: z.array(z.string()).optional(),
+        ai_summary: z.string().optional(),
+        updated: z.union([z.string(), z.date()]).optional()
       })
     })
   }),

src/pages/docs-suggestions.json.ts

@@ -9,7 +9,12 @@ export const GET: APIRoute = () => {
         page_id: docs[url].frontmatter.page_id,
         title: docs[url].frontmatter.title,
         url: "https://docs.kinde.com" + url.split("/content/docs")[1].split(".")[0] + "/",
-        app_context: docs[url].frontmatter.app_context
+        app_context: docs[url].frontmatter.app_context,
+        audience: docs[url].frontmatter.audience,
+        complexity: docs[url].frontmatter.complexity,
+        keywords: docs[url].frontmatter.keywords,
+        ai_summary: docs[url].frontmatter.ai_summary,
+        updated: docs[url].frontmatter.updated
       })),
       null,
       2

src/starlight-overrides/Head.astro

@@ -5,6 +5,10 @@ import type {Props} from "@astrojs/starlight/props";
 const hasCustomOGImage = Astro.props.entry.data.head.find((t) =>
   t.attrs.property === "og:image" ? true : false
 );
+
+// Extract frontmatter data for structured data
+const { entry } = Astro.props;
+const frontmatter = entry.data;
 ---
 
 {
@@ -18,3 +22,36 @@ const hasCustomOGImage = Astro.props.entry.data.head.find((t) =>
 </Default>
 
 {!hasCustomOGImage && <meta property="og:image" content={`${Astro.url.href}og-image.png`} />}
+
+{/* Add meta tags for the new fields */}
+{frontmatter.audience && (
+  <meta name="audience" content={Array.isArray(frontmatter.audience) ? frontmatter.audience.join(', ') : frontmatter.audience} />
+)}
+{frontmatter.complexity && (
+  <meta name="complexity" content={frontmatter.complexity} />
+)}
+{frontmatter.keywords && (
+  <meta name="keywords" content={frontmatter.keywords.join(', ')} />
+)}
+{frontmatter.ai_summary && (
+  <meta name="ai-summary" content={frontmatter.ai_summary} />
+)}
+
+{/* Add JSON-LD structured data */}
+<script type="application/ld+json" set:html={JSON.stringify({
+  "@context": "https://schema.org",
+  "@type": "TechArticle",
+  "name": frontmatter.title,
+  "description": frontmatter.description,
+  "keywords": frontmatter.keywords?.join(', '),
+  "audience": Array.isArray(frontmatter.audience) ? frontmatter.audience.join(', ') : frontmatter.audience,
+  "difficulty": frontmatter.complexity,
+  "abstract": frontmatter.ai_summary,
+  "url": Astro.url.href,
+  ...(frontmatter.updated && { "dateModified": typeof frontmatter.updated === 'string' ? frontmatter.updated : frontmatter.updated.toISOString() }),
+  "publisher": {
+    "@type": "Organization",
+    "name": "Kinde",
+    "url": "https://kinde.com"
+  }
+})} />