Refactor SEO implementation for maintainability and type safety

Eliminates code duplication across 13+ files by centralizing SEO constants,
creating reusable schema builders, and establishing single sources of truth.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: mostlyerror

app/blog/[slug]/page.tsx

@@ -6,6 +6,9 @@ import RichText from '@/components/RichText'
 import CTA from '@/components/CTA'
 import { getAllBlogPosts, getBlogPostBySlug } from '@/lib/sanity.client'
 import { urlFor } from '@/lib/sanity.image'
+import { SEO } from '@/lib/seo.constants'
+import { buildBlogPostingSchema } from '@/lib/schema-builders'
+import { JsonLd } from '@/components/JsonLd'
 
 interface BlogPostPageProps {
   params: Promise<{
@@ -60,7 +63,7 @@ export async function generateMetadata({ params }: BlogPostPageProps): Promise<M
     openGraph: {
       title: post.title,
       description: metaDescription,
-      url: `https://goodrobotco.com/blog/${post.slug}`,
+      url: `${SEO.baseUrl}/blog/${post.slug}`,
       type: 'article',
       publishedTime: post.publishedAt,
       authors: [post.author],
@@ -104,6 +107,19 @@ export default async function BlogPostPage({ params }: BlogPostPageProps) {
 
       {/* Blog Post Content */}
       <article className="py-12 bg-cream">
+        <JsonLd
+          data={buildBlogPostingSchema({
+            ...post,
+            excerpt: post.excerpt || '',
+            featuredImage: post.featuredImage?.asset
+              ? {
+                  asset: {
+                    url: urlFor(post.featuredImage.asset).width(1200).height(630).url(),
+                  },
+                }
+              : undefined,
+          })}
+        />
         <div className="max-w-4xl mx-auto px-6">
           {/* Meta info */}
           <div className="flex items-center gap-4 text-sm text-charcoal-light mb-8">

app/case-studies/llt/page.tsx

@@ -2,15 +2,45 @@ import type { Metadata } from "next";
 import Link from "next/link";
 import HeroSimple from "@/components/HeroSimple";
 import CTA from "@/components/CTA";
+import { SEO } from "@/lib/seo.constants";
+import { buildBreadcrumbSchema } from "@/lib/schema-builders";
+import { JsonLd } from "@/components/JsonLd";
 
 export const metadata: Metadata = {
   title: "Case Study: Let's Learn Together | Good Robot Co.",
   description: "How we helped a growing tutoring agency streamline operations, evaluate business software, and implement the right platform for long-term growth.",
+  openGraph: {
+    title: "Let's Learn Together: Operations & Technology Advisory | Good Robot Co.",
+    description: "From manual spreadsheets to scalable systems—saving hours weekly and setting up a tutoring agency for growth.",
+    url: `${SEO.baseUrl}/case-studies/llt`,
+    type: 'article',
+    images: [
+      {
+        url: '/og-image.png',
+        width: 1200,
+        height: 630,
+        alt: "Good Robot Co. - Technology That Works For Your Business",
+      },
+    ],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: "Let's Learn Together: Operations & Technology Advisory",
+    description: "From manual spreadsheets to scalable systems—saving hours weekly and setting up a tutoring agency for growth.",
+    images: ['/og-image.png'],
+  },
 };
 
 export default function LLTCaseStudy() {
   return (
     <>
+      <JsonLd
+        data={buildBreadcrumbSchema([
+          { name: 'Home', url: SEO.baseUrl },
+          { name: 'Case Studies', url: `${SEO.baseUrl}/case-studies` },
+          { name: "Let's Learn Together", url: `${SEO.baseUrl}/case-studies/llt` },
+        ])}
+      />
       <HeroSimple
         title="Let's Learn Together: Operations & Technology Advisory"
         subtitle="From manual spreadsheets to scalable systems—saving hours weekly and setting up a tutoring agency for growth"

app/case-studies/mayday/page.tsx

@@ -2,15 +2,45 @@ import type { Metadata } from "next";
 import Image from "next/image";
 import HeroSimple from "@/components/HeroSimple";
 import CTA from "@/components/CTA";
+import { SEO } from "@/lib/seo.constants";
+import { buildBreadcrumbSchema } from "@/lib/schema-builders";
+import { JsonLd } from "@/components/JsonLd";
 
 export const metadata: Metadata = {
   title: "Case Study: Mayday | Good Robot Co.",
   description: "How we built an intelligent lead generation system that automatically discovers and qualifies web development opportunities.",
+  openGraph: {
+    title: "Mayday: Intelligent Lead Generation | Good Robot Co.",
+    description: "Automating the hunt for web development clients—from 15 hours/week of manual work to zero.",
+    url: `${SEO.baseUrl}/case-studies/mayday`,
+    type: 'article',
+    images: [
+      {
+        url: '/case-studies/mayday/dashboard.png',
+        width: 1600,
+        height: 1200,
+        alt: 'Mayday lead generation dashboard showing automated business scanning',
+      },
+    ],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: "Mayday: Intelligent Lead Generation",
+    description: "Automating the hunt for web development clients—from 15 hours/week of manual work to zero.",
+    images: ['/case-studies/mayday/dashboard.png'],
+  },
 };
 
 export default function MaydayCaseStudy() {
   return (
     <>
+      <JsonLd
+        data={buildBreadcrumbSchema([
+          { name: 'Home', url: SEO.baseUrl },
+          { name: 'Case Studies', url: `${SEO.baseUrl}/case-studies` },
+          { name: 'Mayday', url: `${SEO.baseUrl}/case-studies/mayday` },
+        ])}
+      />
       <HeroSimple
         title="Mayday: Intelligent Lead Generation"
         subtitle="Automating the hunt for web development clients—from 15 hours/week of manual work to zero"

app/case-studies/swapp/page.tsx

@@ -3,15 +3,45 @@ import Link from "next/link";
 import Image from "next/image";
 import HeroSimple from "@/components/HeroSimple";
 import CTA from "@/components/CTA";
+import { SEO } from "@/lib/seo.constants";
+import { buildBreadcrumbSchema } from "@/lib/schema-builders";
+import { JsonLd } from "@/components/JsonLd";
 
 export const metadata: Metadata = {
   title: "Case Study: SWAPP | Good Robot Co.",
   description: "How we built a rapid-response system that reduced intake time from 11 minutes to 2.5 minutes and prevented 8,300+ nights of unsheltered homelessness.",
+  openGraph: {
+    title: "SWAPP: Severe Weather Emergency Response | Good Robot Co.",
+    description: "From weekend prototype to production—reducing intake time by 80% during Colorado's coldest winter.",
+    url: `${SEO.baseUrl}/case-studies/swapp`,
+    type: 'article',
+    images: [
+      {
+        url: '/case-studies/swapp/intake-session.jpg',
+        width: 1600,
+        height: 1200,
+        alt: 'Caseworker conducting digital intake during severe weather',
+      },
+    ],
+  },
+  twitter: {
+    card: 'summary_large_image',
+    title: "SWAPP: Severe Weather Emergency Response",
+    description: "Reducing intake time by 80% during Colorado's coldest winter.",
+    images: ['/case-studies/swapp/intake-session.jpg'],
+  },
 };
 
 export default function SwappCaseStudy() {
   return (
     <>
+      <JsonLd
+        data={buildBreadcrumbSchema([
+          { name: 'Home', url: SEO.baseUrl },
+          { name: 'Case Studies', url: `${SEO.baseUrl}/case-studies` },
+          { name: 'SWAPP', url: `${SEO.baseUrl}/case-studies/swapp` },
+        ])}
+      />
       <HeroSimple
         title="SWAPP: Severe Weather Emergency Response"
         subtitle="From weekend prototype to production—reducing intake time by 80% during Colorado's coldest winter"

app/layout.tsx

@@ -5,6 +5,9 @@ import Nav from '@/components/Nav'
 import Footer from '@/components/Footer'
 import { Analytics } from '@vercel/analytics/next'
 import { SpeedInsights } from '@vercel/speed-insights/next'
+import { SEO } from '@/lib/seo.constants'
+import { buildOrganizationSchema } from '@/lib/schema-builders'
+import { JsonLd } from '@/components/JsonLd'
 
 const dmSans = DM_Sans({
   subsets: ['latin'],
@@ -24,29 +27,29 @@ const fraunces = Fraunces({
 
 export const metadata: Metadata = {
   title: 'Good Robot Co. | Technology That Works For Your Business',
-  description: 'Technology consulting for small and mid-size businesses. Honest guidance, practical solutions, and the right tech approach for your needs.',
-  metadataBase: new URL('https://goodrobotco.com'),
+  description: SEO.organization.description,
+  metadataBase: new URL(SEO.baseUrl),
   openGraph: {
     title: 'Good Robot Co. | Technology That Works For Your Business',
-    description: 'Technology consulting for small and mid-size businesses. Honest guidance, practical solutions, and the right tech approach for your needs.',
-    url: 'https://goodrobotco.com',
-    siteName: 'Good Robot Co.',
+    description: SEO.organization.description,
+    url: SEO.baseUrl,
+    siteName: SEO.siteName,
     locale: 'en_US',
     type: 'website',
     images: [
       {
-        url: '/og-image.png',
-        width: 1200,
-        height: 630,
-        alt: 'Good Robot Co. - Technology That Works For Your Business',
+        url: SEO.images.og.url,
+        width: SEO.images.og.width,
+        height: SEO.images.og.height,
+        alt: SEO.images.og.alt,
       },
     ],
   },
   twitter: {
     card: 'summary_large_image',
     title: 'Good Robot Co. | Technology That Works For Your Business',
-    description: 'Technology consulting for small and mid-size businesses. Honest guidance, practical solutions, and the right tech approach for your needs.',
-    images: ['/og-image.png'],
+    description: SEO.organization.description,
+    images: [SEO.images.og.url],
   },
 }
 
@@ -58,6 +61,7 @@ export default function RootLayout({
   return (
     <html lang="en" className={`${dmSans.variable} ${fraunces.variable}`}>
       <body className="bg-cream text-charcoal text-[17px] leading-relaxed overflow-x-hidden font-body">
+        <JsonLd data={buildOrganizationSchema()} />
         <Nav />
         <main>{children}</main>
         <Footer />

app/page.tsx

@@ -1,9 +1,48 @@
 import Image from 'next/image'
 import Link from 'next/link'
 import CTA from '@/components/CTA'
-import { HEADSHOT_SRC } from '@/components/constants'
+import { JsonLd } from '@/components/JsonLd'
 
 export default function Home() {
+  const faqSchema = {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: [
+      {
+        '@type': 'Question',
+        name: 'What if a developer ghosted us and our website is broken?',
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: 'Good Robot Co. specializes in tech rescue services, helping businesses recover from abandoned projects and fixing broken websites.',
+        },
+      },
+      {
+        '@type': 'Question',
+        name: 'Can AI actually help my business?',
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: 'Good Robot Co. provides practical AI integration services, cutting through the hype to implement AI solutions that are actually useful and maintainable for your business.',
+        },
+      },
+      {
+        '@type': 'Question',
+        name: 'Why am I being quoted $50K for simple software?',
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: 'Good Robot Co. offers right-sized solutions that match the problem to your actual needs and budget, with fair pricing and no overselling.',
+        },
+      },
+      {
+        '@type': 'Question',
+        name: 'How can I automate manual processes?',
+        acceptedAnswer: {
+          '@type': 'Answer',
+          text: 'Good Robot Co. specializes in process automation using tools like Zapier, Make, or custom scripts to eliminate repetitive tasks.',
+        },
+      },
+    ],
+  }
+
   return (
     <>
       {/* Hero */}
@@ -80,6 +119,7 @@ export default function Home() {
 
       {/* Sound Familiar + Philosophy Combined */}
       <section className="py-20 bg-white">
+        <JsonLd data={faqSchema} />
         <div className="max-w-4xl mx-auto px-6">
           <h2 className="text-2xl md:text-3xl font-semibold mb-8">Sound familiar?</h2>
 
@@ -113,9 +153,11 @@ export default function Home() {
               <p>I&apos;m transparent about where I am: building my portfolio with real client projects. That means accessible pricing and personalized attention.</p>
             </div>
             <div className="flex items-center gap-3">
-              <img 
-                src={HEADSHOT_SRC} 
-                alt="Ben Poon" 
+              <Image
+                src="/ben-headshot.jpg"
+                alt="Ben Poon"
+                width={64}
+                height={64}
                 className="w-16 h-16 rounded-full object-cover ring-2 ring-cream"
               />
               <div>

app/sitemap.ts

@@ -1,58 +1,63 @@
 import { MetadataRoute } from 'next'
+import { getAllBlogPosts } from '@/lib/sanity.client'
+import { SEO } from '@/lib/seo.constants'
+import { CASE_STUDIES } from '@/lib/case-studies.config'
 
 export const dynamic = 'force-static'
 
-export default function sitemap(): MetadataRoute.Sitemap {
-  const baseUrl = 'https://goodrobotco.com'
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  // Fetch blog posts from Sanity at build time
+  const blogPosts = await getAllBlogPosts()
 
-  return [
+  // Static pages
+  const staticPages: MetadataRoute.Sitemap = [
     {
-      url: baseUrl,
+      url: SEO.baseUrl,
       lastModified: new Date(),
       changeFrequency: 'monthly',
       priority: 1,
     },
     {
-      url: `${baseUrl}/ai-for-business`,
+      url: `${SEO.baseUrl}/ai-for-business`,
       lastModified: new Date(),
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     {
-      url: `${baseUrl}/pricing`,
+      url: `${SEO.baseUrl}/pricing`,
       lastModified: new Date(),
       changeFrequency: 'monthly',
       priority: 0.8,
     },
     {
-      url: `${baseUrl}/case-studies`,
+      url: `${SEO.baseUrl}/case-studies`,
       lastModified: new Date(),
       changeFrequency: 'monthly',
       priority: 0.9,
     },
     {
-      url: `${baseUrl}/case-studies/swapp`,
-      lastModified: new Date(),
-      changeFrequency: 'monthly',
-      priority: 0.8,
-    },
-    {
-      url: `${baseUrl}/case-studies/mayday`,
-      lastModified: new Date(),
-      changeFrequency: 'monthly',
-      priority: 0.8,
-    },
-    {
-      url: `${baseUrl}/case-studies/llt`,
-      lastModified: new Date(),
-      changeFrequency: 'monthly',
-      priority: 0.8,
-    },
-    {
-      url: `${baseUrl}/blog`,
+      url: `${SEO.baseUrl}/blog`,
       lastModified: new Date(),
       changeFrequency: 'weekly',
       priority: 0.6,
     },
   ]
+
+  // Add dynamic case study pages
+  const caseStudyPages: MetadataRoute.Sitemap = CASE_STUDIES.map((study) => ({
+    url: `${SEO.baseUrl}/case-studies/${study.slug}`,
+    lastModified: new Date(),
+    changeFrequency: 'monthly' as const,
+    priority: study.priority,
+  }))
+
+  // Add dynamic blog post pages
+  const blogPostPages: MetadataRoute.Sitemap = blogPosts.map((post) => ({
+    url: `${SEO.baseUrl}/blog/${post.slug}`,
+    lastModified: new Date(post.publishedAt),
+    changeFrequency: 'monthly',
+    priority: 0.7,
+  }))
+
+  return [...staticPages, ...caseStudyPages, ...blogPostPages]
 }