Improve SEO metadata and structured data

app/[lang]/page.tsx

@@ -1,7 +1,8 @@
 import type { Metadata } from "next";
 import { notFound } from "next/navigation";
 import { HomePage } from "@/components/home-page";
-import { getPortfolioContent, isLanguage, languages, type Language } from "@/data/portfolio";
+import { isLanguage, languages, type Language } from "@/data/portfolio";
+import { getHomeMetadata } from "@/data/seo";
 
 export function generateStaticParams() {
   return languages.map((lang) => ({ lang }));
@@ -12,20 +13,7 @@ export function generateMetadata({ params }: { params: { lang: string } }): Meta
     return {};
   }
 
-  const language = params.lang as Language;
+  return getHomeMetadata(params.lang as Language);
-  const t = getPortfolioContent(language);
-
-  return {
-    title: t.meta.title,
-    description: t.meta.description,
-    alternates: {
-      canonical: `/${language}`,
-      languages: {
-        en: "/en",
-        ar: "/ar",
-      },
-    },
-  };
 }
 
 export default function LocalizedHomePage({ params }: { params: { lang: string } }) {

app/[lang]/resume/page.tsx

@@ -1,7 +1,8 @@
 import type { Metadata } from "next";
 import { notFound } from "next/navigation";
 import { ResumePageContent } from "@/components/resume-page-content";
-import { getPortfolioContent, isLanguage, languages, type Language } from "@/data/portfolio";
+import { isLanguage, languages, type Language } from "@/data/portfolio";
+import { getResumeMetadata } from "@/data/seo";
 
 export function generateStaticParams() {
   return languages.map((lang) => ({ lang }));
@@ -12,20 +13,7 @@ export function generateMetadata({ params }: { params: { lang: string } }): Meta
     return {};
   }
 
-  const language = params.lang as Language;
+  return getResumeMetadata(params.lang as Language);
-  const t = getPortfolioContent(language);
-
-  return {
-    title: language === "ar" ? `السيرة الذاتية | ${t.meta.title}` : `Resume | ${t.meta.title}`,
-    description: t.resume.description,
-    alternates: {
-      canonical: `/${language}/resume`,
-      languages: {
-        en: "/en/resume",
-        ar: "/ar/resume",
-      },
-    },
-  };
 }
 
 export default function LocalizedResumePage({ params }: { params: { lang: string } }) {

app/layout.tsx

@@ -1,6 +1,8 @@
 import type { Metadata } from "next";
 import "./globals.css";
 import "./portfolio.css";
+import { getDefaultSeoMetadata } from "@/data/seo";
+import { siteUrl } from "@/data/site-config";
 
 const themeInitScript = `
 (() => {
@@ -18,22 +20,8 @@ const themeInitScript = `
 `;
 
 export const metadata: Metadata = {
-  title: "Grace Butrus Salmoun | Architectural Engineer Specialized in Architectural Design",
+  metadataBase: new URL(siteUrl),
-  description:
+  ...getDefaultSeoMetadata(),
-    "A bilingual architecture portfolio for Grace Butrus Salmoun, an architectural engineer specialized in architectural design, working across urban rehabilitation, landscape, shop drawings, and visual presentation.",
-  metadataBase: new URL("https://grace-salamoun-architect.vercel.app"),
-  openGraph: {
-    title: "Grace Butrus Salmoun | Architectural Engineer Specialized in Architectural Design",
-    description:
-      "Architectural design, urban rehabilitation, landscape, shop drawings, and visual presentation in English and Arabic.",
-    type: "website",
-  },
-  twitter: {
-    card: "summary_large_image",
-    title: "Grace Butrus Salmoun | Architectural Engineer Specialized in Architectural Design",
-    description:
-      "A bilingual architecture portfolio featuring selected works, technical documentation, and visual presentation.",
-  },
 };
 
 export default function RootLayout({

app/robots.ts

@@ -1,4 +1,5 @@
-import type { MetadataRoute } from "next";
+import type { MetadataRoute } from "next";
+import { absoluteUrl, siteUrl } from "@/data/site-config";
 
 export default function robots(): MetadataRoute.Robots {
   return {
@@ -6,6 +7,7 @@ export default function robots(): MetadataRoute.Robots {
       userAgent: "*",
       allow: "/",
     },
-    sitemap: "https://grace-salamoun-architect.vercel.app/sitemap.xml",
+    host: siteUrl,
+    sitemap: absoluteUrl("/sitemap.xml"),
   };
 }

app/sitemap.ts

@@ -1,30 +1,30 @@
-import type { MetadataRoute } from "next";
+import type { MetadataRoute } from "next";
+import { absoluteUrl } from "@/data/site-config";
 
 export default function sitemap(): MetadataRoute.Sitemap {
-  const baseUrl = "https://grace-salamoun-architect.vercel.app";
+  const lastModified = new Date();
-  const lastModified = new Date("2026-04-18T00:00:00.000Z");
 
   return [
     {
-      url: `${baseUrl}/en`,
+      url: absoluteUrl("/en"),
       lastModified,
       changeFrequency: "monthly",
       priority: 1,
     },
     {
-      url: `${baseUrl}/ar`,
+      url: absoluteUrl("/ar"),
       lastModified,
       changeFrequency: "monthly",
       priority: 1,
     },
     {
-      url: `${baseUrl}/en/resume`,
+      url: absoluteUrl("/en/resume"),
       lastModified,
       changeFrequency: "monthly",
       priority: 0.8,
     },
     {
-      url: `${baseUrl}/ar/resume`,
+      url: absoluteUrl("/ar/resume"),
       lastModified,
       changeFrequency: "monthly",
       priority: 0.8,

components/home-page.tsx

@@ -1,5 +1,6 @@
 import Image from "next/image";
 import Link from "next/link";
+import { JsonLd } from "@/components/json-ld";
 import { ProjectCard } from "@/components/project-card";
 import { SectionHeading } from "@/components/section-heading";
 import { SiteShell } from "@/components/site-shell";
@@ -11,12 +12,14 @@ import {
   sharedProfile,
   type Language,
 } from "@/data/portfolio";
+import { getHomeStructuredData } from "@/data/seo";
 
 export function HomePage({ language }: { language: Language }) {
   const dir = getDirection(language);
   const t = portfolioContent[language];
   const founderName = language === "ar" ? sharedProfile.founderNameAr : sharedProfile.founderNameEn;
   const address = language === "ar" ? sharedProfile.addressAr : sharedProfile.address;
+  const structuredData = getHomeStructuredData(language);
   const heroImageAlt =
     language === "ar"
       ? "لوحة بورتفوليو لمجمع إعلامي ومبنى التلفزيون"
@@ -50,6 +53,7 @@ export function HomePage({ language }: { language: Language }) {
 
   return (
     <SiteShell language={language}>
+      <JsonLd data={structuredData} />
       <div className="top-wash pointer-events-none absolute inset-x-0 top-0 h-[720px]" />
 
       <main className="site-container flex flex-col gap-12 py-6 md:gap-14 md:py-8 lg:gap-16 lg:py-10">

components/json-ld.tsx

@@ -0,0 +1,7 @@
+type JsonLdProps = {
+  data: Record<string, unknown> | Array<Record<string, unknown>>;
+};
+
+export function JsonLd({ data }: JsonLdProps) {
+  return <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(data) }} />;
+}

components/resume-page-content.tsx

@@ -1,16 +1,20 @@
 import Link from "next/link";
+import { JsonLd } from "@/components/json-ld";
 import { SectionHeading } from "@/components/section-heading";
 import { SiteShell } from "@/components/site-shell";
 import { portfolioContent, resumeFile, sharedProfile, type Language } from "@/data/portfolio";
+import { getResumeStructuredData } from "@/data/seo";
 
 export function ResumePageContent({ language }: { language: Language }) {
   const t = portfolioContent[language];
   const brandName = language === "ar" ? sharedProfile.brandNameAr : sharedProfile.brandNameEn;
   const address = language === "ar" ? sharedProfile.addressAr : sharedProfile.address;
   const hasResume = resumeFile.available;
+  const structuredData = getResumeStructuredData(language);
 
   return (
     <SiteShell language={language}>
+      <JsonLd data={structuredData} />
       <main className="site-container flex flex-col gap-10 py-8 md:py-10 lg:gap-12 lg:py-12">
         <section className="section-shell hero-glow">
           <div className="section-padding grid gap-8 lg:grid-cols-[1fr_auto] lg:items-end">

data/seo.ts

@@ -0,0 +1,256 @@
+import type { Metadata } from "next";
+import { englishPortfolioContent, getPortfolioContent, sharedProfile, type Language } from "@/data/portfolio";
+import { absoluteUrl, siteName } from "@/data/site-config";
+
+const sharedKeywords = [
+  "architecture portfolio",
+  "architectural engineer",
+  "architectural design",
+  "urban rehabilitation",
+  "landscape design",
+  "shop drawings",
+  "architectural visualization",
+  "Damascus architect",
+];
+
+const localizedKeywords: Record<Language, string[]> = {
+  en: ["portfolio architect", "presentation boards", "mixed-use towers", "hospitality design"],
+  ar: ["بورتفوليو معماري", "مهندسة معمارية", "تصميم معماري", "إعادة تأهيل عمراني"],
+};
+
+function getLocale(language: Language) {
+  return language === "ar" ? "ar_SY" : "en_US";
+}
+
+function getAlternateLocales(language: Language) {
+  return language === "ar" ? ["en_US"] : ["ar_SY"];
+}
+
+function getOgImage(language: Language) {
+  return {
+    url: absoluteUrl(sharedProfile.heroImage),
+    alt:
+      language === "ar"
+        ? "معاينة بورتفوليو غريس بطرس سلمون"
+        : "Portfolio preview for Grace Butrus Salmoun",
+  };
+}
+
+function buildMetadata({
+  language,
+  title,
+  description,
+  canonicalPath,
+  pageType,
+}: {
+  language: Language;
+  title: string;
+  description: string;
+  canonicalPath: string;
+  pageType: "website" | "profile";
+}): Metadata {
+  const ogImage = getOgImage(language);
+
+  return {
+    title,
+    description,
+    keywords: [...sharedKeywords, ...localizedKeywords[language]],
+    authors: [{ name: sharedProfile.founderNameEn }],
+    creator: sharedProfile.founderNameEn,
+    publisher: sharedProfile.founderNameEn,
+    category: "architecture portfolio",
+    alternates: {
+      canonical: canonicalPath,
+      languages: {
+        en: canonicalPath.includes("/resume") ? "/en/resume" : "/en",
+        ar: canonicalPath.includes("/resume") ? "/ar/resume" : "/ar",
+        "x-default": "/en",
+      },
+    },
+    robots: {
+      index: true,
+      follow: true,
+      googleBot: {
+        index: true,
+        follow: true,
+        "max-image-preview": "large",
+        "max-snippet": -1,
+        "max-video-preview": -1,
+      },
+    },
+    openGraph: {
+      title,
+      description,
+      url: absoluteUrl(canonicalPath),
+      siteName,
+      locale: getLocale(language),
+      alternateLocale: getAlternateLocales(language),
+      type: pageType,
+      images: [ogImage],
+    },
+    twitter: {
+      card: "summary_large_image",
+      title,
+      description,
+      images: [ogImage.url],
+    },
+  };
+}
+
+export function getDefaultSeoMetadata(): Metadata {
+  const title = englishPortfolioContent.meta.title;
+  const description = englishPortfolioContent.meta.description;
+  const ogImage = getOgImage("en");
+
+  return {
+    title,
+    description,
+    applicationName: siteName,
+    authors: [{ name: sharedProfile.founderNameEn }],
+    creator: sharedProfile.founderNameEn,
+    publisher: sharedProfile.founderNameEn,
+    keywords: [...sharedKeywords, ...localizedKeywords.en],
+    category: "architecture portfolio",
+    referrer: "origin-when-cross-origin",
+    robots: {
+      index: true,
+      follow: true,
+      googleBot: {
+        index: true,
+        follow: true,
+        "max-image-preview": "large",
+        "max-snippet": -1,
+        "max-video-preview": -1,
+      },
+    },
+    openGraph: {
+      title,
+      description,
+      url: absoluteUrl("/en"),
+      siteName,
+      locale: "en_US",
+      alternateLocale: ["ar_SY"],
+      type: "website",
+      images: [ogImage],
+    },
+    twitter: {
+      card: "summary_large_image",
+      title,
+      description,
+      images: [ogImage.url],
+    },
+  };
+}
+
+export function getHomeMetadata(language: Language): Metadata {
+  const t = getPortfolioContent(language);
+
+  return buildMetadata({
+    language,
+    title: t.meta.title,
+    description: t.meta.description,
+    canonicalPath: `/${language}`,
+    pageType: "website",
+  });
+}
+
+export function getResumeMetadata(language: Language): Metadata {
+  const t = getPortfolioContent(language);
+  const title = language === "ar" ? `السيرة الذاتية | ${t.meta.title}` : `Resume | ${t.meta.title}`;
+
+  return buildMetadata({
+    language,
+    title,
+    description: t.resume.description,
+    canonicalPath: `/${language}/resume`,
+    pageType: "profile",
+  });
+}
+
+export function getHomeStructuredData(language: Language) {
+  const t = getPortfolioContent(language);
+  const name = language === "ar" ? sharedProfile.founderNameAr : sharedProfile.founderNameEn;
+  const address = language === "ar" ? sharedProfile.addressAr : sharedProfile.address;
+
+  return [
+    {
+      "@context": "https://schema.org",
+      "@type": "WebSite",
+      name: siteName,
+      url: absoluteUrl("/"),
+      inLanguage: ["en", "ar"],
+    },
+    {
+      "@context": "https://schema.org",
+      "@type": "Person",
+      name,
+      url: absoluteUrl(`/${language}`),
+      image: absoluteUrl(sharedProfile.heroImage),
+      jobTitle: t.ui.architectureEngineer,
+      description: t.meta.description,
+      email: sharedProfile.email,
+      telephone: sharedProfile.phone,
+      address: {
+        "@type": "PostalAddress",
+        addressLocality: address,
+        addressCountry: "SY",
+      },
+      sameAs: [sharedProfile.facebookHref],
+      knowsAbout: [...t.craft.skills.slice(0, 4), ...t.sectors.categories.slice(0, 4)],
+    },
+    {
+      "@context": "https://schema.org",
+      "@type": "CollectionPage",
+      name: t.meta.title,
+      description: t.meta.description,
+      url: absoluteUrl(`/${language}`),
+      inLanguage: language,
+      isPartOf: {
+        "@type": "WebSite",
+        name: siteName,
+        url: absoluteUrl("/"),
+      },
+      about: {
+        "@type": "Person",
+        name,
+      },
+    },
+  ];
+}
+
+export function getResumeStructuredData(language: Language) {
+  const t = getPortfolioContent(language);
+  const name = language === "ar" ? sharedProfile.founderNameAr : sharedProfile.founderNameEn;
+  const title = language === "ar" ? `السيرة الذاتية | ${name}` : `Resume | ${name}`;
+
+  return [
+    {
+      "@context": "https://schema.org",
+      "@type": "Person",
+      name,
+      url: absoluteUrl(`/${language}`),
+      email: sharedProfile.email,
+      telephone: sharedProfile.phone,
+      image: absoluteUrl(sharedProfile.heroImage),
+      jobTitle: t.ui.architectureEngineer,
+      sameAs: [sharedProfile.facebookHref],
+    },
+    {
+      "@context": "https://schema.org",
+      "@type": "ProfilePage",
+      name: title,
+      description: t.resume.description,
+      url: absoluteUrl(`/${language}/resume`),
+      inLanguage: language,
+      isPartOf: {
+        "@type": "WebSite",
+        name: siteName,
+        url: absoluteUrl("/"),
+      },
+      about: {
+        "@type": "Person",
+        name,
+      },
+    },
+  ];
+}

data/site-config.ts

@@ -0,0 +1,8 @@
+const FALLBACK_SITE_URL = "https://grace-salamoun-architect.vercel.app";
+
+export const siteName = "Grace Butrus Salmoun Portfolio";
+export const siteUrl = (process.env.NEXT_PUBLIC_SITE_URL ?? FALLBACK_SITE_URL).replace(/\/+$/, "");
+
+export function absoluteUrl(path = "/") {
+  return new URL(path, `${siteUrl}/`).toString();
+}