✨ feat: enhance structured data and SEO metadata across blog and index pages

AR10Dev · web-flow · commit a738fe007135 · 2026-04-06T07:42:28.000Z
diff --git a/src/layouts/BaseLayout.astro b/src/layouts/BaseLayout.astro
@@ -17,21 +17,23 @@ export interface Props {
   publishedTime?: string;
   modifiedTime?: string;
   author?: string;
+  readingTime?: string;
 }
 
 const siteUrl = "https://avaabrazzaq.com";
 const {
   title,
   description,
   canonicalUrl = new URL(Astro.url.pathname, siteUrl).toString(),
-  ogImage = new URL("/og-ai-growth-engineer.svg", siteUrl).toString(),
+  ogImage = new URL("/og-ai-growth-engineer.png", siteUrl).toString(),
   ogType = "website",
   structuredData,
   noIndex = false,
   keywords,
   publishedTime,
   modifiedTime,
   author = "Avaab Razzaq",
+  readingTime,
 } = Astro.props;
 
 const defaultKeywords =
@@ -71,6 +73,7 @@ const currentPath = Astro.url.pathname;
     <link rel="icon" type="image/x-icon" href="/favicon.ico" />
     <link rel="shortcut icon" type="image/x-icon" href="/favicon.ico" />
     <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png" />
+    <meta name="msapplication-TileImage" content="/pwa-192x192.png" />
     <link rel="canonical" href={canonicalUrl} />
     <link rel="sitemap" href="/sitemap-index.xml" />
     <link rel="alternate" type="application/rss+xml" title="Avaab Razzaq Blog RSS Feed" href="/blog/rss.xml" />
@@ -112,9 +115,23 @@ const currentPath = Astro.url.pathname;
 
     {/* Twitter/X Card */}
     <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:site" content="@itsmeAvaab" />
+    <meta name="twitter:creator" content="@itsmeAvaab" />
     <meta name="twitter:title" content={title} />
     <meta name="twitter:description" content={description} />
     <meta name="twitter:image" content={ogImage} />
+    {ogType === "article" && (
+      <>
+        <meta name="twitter:label1" content="Written by" />
+        <meta name="twitter:data1" content={author} />
+        {readingTime && (
+          <>
+            <meta name="twitter:label2" content="Est. reading time" />
+            <meta name="twitter:data2" content={readingTime} />
+          </>
+        )}
+      </>
+    )}
 
     <meta name="theme-color" content="#0e2a47" />
 
diff --git a/src/pages/blog/[...slug].astro b/src/pages/blog/[...slug].astro
@@ -79,12 +79,13 @@ const { post, relatedService, relatedPosts, relatedPortfolio } = Astro.props;
 const { Content, headings } = await render(post);
 
 const siteUrl = "https://avaabrazzaq.com";
+const postUrl = new URL(`/blog/${post.id}/`, siteUrl).toString();
 const title = `${post.data.title} | Blog - Avaab Razzaq`;
 const description = post.data.description;
-const canonicalUrl = new URL(`/blog/${post.id}/`, siteUrl).toString();
+const canonicalUrl = postUrl;
 const ogImage =
   post.data.image?.src ??
-  new URL("/og-ai-growth-engineer.svg", siteUrl).toString();
+  new URL("/og-ai-growth-engineer.png", siteUrl).toString();
 
 // Format date helper
 function formatDate(date: Date): string {
@@ -97,7 +98,8 @@ function formatDate(date: Date): string {
 
 // Calculate reading time if not in frontmatter
 const wordCount = (post.body ?? "").split(/\s+/).filter(Boolean).length;
-const readingTime = post.data.readingTime || Math.ceil(wordCount / 200);
+const readingTimeMinutes = post.data.readingTime || Math.ceil(wordCount / 200);
+const readingTimeString = `${readingTimeMinutes} ${readingTimeMinutes === 1 ? "minute" : "minutes"}`;
 
 // Build the structured data graph
 const structuredDataGraph: Record<string, unknown>[] = [
@@ -108,27 +110,21 @@ const structuredDataGraph: Record<string, unknown>[] = [
     name: "Avaab Razzaq - AI Growth Engineer",
     description:
       "AI Growth Engineer specializing in web apps, AI automation, and technical SEO",
-    publisher: { "@id": `${siteUrl}/#person` },
+    publisher: { "@id": `${siteUrl}/#organization` },
   },
   {
-    "@type": "WebPage",
-    "@id": canonicalUrl,
-    url: canonicalUrl,
-    name: title,
-    description: description,
-    isPartOf: { "@id": `${siteUrl}/#website` },
-    breadcrumb: {
-      "@type": "BreadcrumbList",
-      itemListElement: [
-        { "@type": "ListItem", position: 1, name: "Home", item: siteUrl },
-        {
-          "@type": "ListItem",
-          position: 2,
-          name: "Blog",
-          item: `${siteUrl}/blog/`,
-        },
-        { "@type": "ListItem", position: 3, name: post.data.title },
-      ],
+    "@type": "Organization",
+    "@id": `${siteUrl}/#organization`,
+    name: "Avaab Razzaq - AI Growth Engineer",
+    url: siteUrl,
+    logo: {
+      "@type": "ImageObject",
+      "@id": `${siteUrl}/#logo`,
+      url: `${siteUrl}/pwa-512x512.png`,
+      contentUrl: `${siteUrl}/pwa-512x512.png`,
+      width: 512,
+      height: 512,
+      caption: "Avaab Razzaq - AI Growth Engineer",
     },
   },
   {
@@ -143,29 +139,51 @@ const structuredDataGraph: Record<string, unknown>[] = [
     ],
   },
   {
-    "@type": "BlogPosting",
-    "@id": `${canonicalUrl}#article`,
+    "@type": "Article",
+    "@id": `${postUrl}#article`,
+    isPartOf: { "@id": postUrl },
+    author: {
+      name: "Avaab Razzaq",
+      "@id": `${siteUrl}/#person`,
+    },
     headline: post.data.title,
-    description: post.data.description,
-    author: { "@id": `${siteUrl}/#person` },
-    publisher: { "@id": `${siteUrl}/#person` },
     datePublished: post.data.publishDate.toISOString(),
-    ...(post.data.updatedDate && {
-      dateModified: post.data.updatedDate.toISOString(),
-    }),
-    ...(post.data.image && {
-      image: {
-        "@type": "ImageObject",
-        url: post.data.image.src,
-        caption: post.data.image.alt,
-      },
-    }),
-    mainEntityOfPage: { "@id": canonicalUrl },
+    dateModified: (post.data.updatedDate ?? post.data.publishDate).toISOString(),
+    mainEntityOfPage: { "@id": postUrl },
+    wordCount: wordCount,
+    publisher: { "@id": `${siteUrl}/#organization` },
+    inLanguage: "en-US",
+    image: post.data.image?.src ?? `${siteUrl}/og-blog.png`,
     keywords: post.data.tags.join(", "),
     articleSection: post.data.category,
+    timeRequired: `PT${readingTimeMinutes}M`,
+  },
+  {
+    "@type": "WebPage",
+    "@id": postUrl,
+    url: postUrl,
+    name: post.data.title,
+    isPartOf: { "@id": `${siteUrl}/#website` },
+    datePublished: post.data.publishDate.toISOString(),
+    dateModified: (post.data.updatedDate ?? post.data.publishDate).toISOString(),
+    description: post.data.description,
+    breadcrumb: { "@id": `${postUrl}#breadcrumb` },
     inLanguage: "en-US",
-    wordCount: wordCount,
-    timeRequired: `PT${readingTime}M`,
+    potentialAction: [
+      {
+        "@type": "ReadAction",
+        target: [postUrl],
+      },
+    ],
+  },
+  {
+    "@type": "BreadcrumbList",
+    "@id": `${postUrl}#breadcrumb`,
+    itemListElement: [
+      { "@type": "ListItem", position: 1, name: "Home", item: siteUrl },
+      { "@type": "ListItem", position: 2, name: "Blog", item: `${siteUrl}/blog/` },
+      { "@type": "ListItem", position: 3, name: post.data.title },
+    ],
   },
 ];
 
@@ -208,6 +226,7 @@ const structuredData = {
   publishedTime={post.data.publishDate.toISOString()}
   modifiedTime={post.data.updatedDate?.toISOString()}
   author={post.data.author}
+  readingTime={readingTimeString}
   structuredData={structuredData}
 >
   <article class="min-h-screen py-12">
@@ -286,7 +305,7 @@ const structuredData = {
               <circle cx="12" cy="12" r="10"></circle>
               <polyline points="12 6 12 12 16 14"></polyline>
             </svg>
-            <span>{readingTime} min read</span>
+            <span>{readingTimeMinutes} min read</span>
           </div>
         </div>
 
diff --git a/src/pages/index.astro b/src/pages/index.astro
@@ -150,18 +150,16 @@ const structuredData = {
       ],
     },
     {
-      "@type": "LocalBusiness",
+      "@type": "ProfessionalService",
       "@id": `${siteUrl}#business`,
       name: "Avaab Razzaq - AI Growth Engineer",
       description: homepage.metaDescription,
       url: siteUrl,
-      telephone: "",
       email: homepage.contactEmail,
       address: {
         "@type": "PostalAddress",
         addressLocality: "Miami",
         addressRegion: "Florida",
-        postalCode: "",
         addressCountry: "US",
       },
       geo: {
@@ -182,6 +180,22 @@ const structuredData = {
         closes: "18:00",
       },
     },
+    {
+      "@type": "Organization",
+      "@id": `${siteUrl}#organization`,
+      name: "Avaab Razzaq - AI Growth Engineer",
+      url: siteUrl,
+      logo: {
+        "@type": "ImageObject",
+        "@id": `${siteUrl}#logo`,
+        url: `${siteUrl}/pwa-512x512.png`,
+        contentUrl: `${siteUrl}/pwa-512x512.png`,
+        width: 512,
+        height: 512,
+        caption: "Avaab Razzaq - AI Growth Engineer",
+      },
+      sameAs: [homepage.githubUrl, linkedInUrl],
+    },
     {
       "@type": "WebSite",
       "@id": `${siteUrl}#website`,
@@ -190,7 +204,19 @@ const structuredData = {
       description: homepage.metaDescription,
       inLanguage: "en-US",
       publisher: {
-        "@id": `${siteUrl}#person`,
+        "@id": `${siteUrl}#organization`,
+      },
+      potentialAction: {
+        "@type": "SearchAction",
+        target: {
+          "@type": "EntryPoint",
+          urlTemplate: `${siteUrl}/blog/?q={search_term_string}`,
+        },
+        "query-input": {
+          "@type": "PropertyValueSpecification",
+          valueRequired: true,
+          valueName: "search_term_string",
+        },
       },
     },
     {
