Centralize SEO metadata and structured data

Introduces shared metadata builders for canonical URLs, Open Graph, and Twitter cards across pages, and adds reusable JSON-LD helpers with WebSite/Organization/SoftwareApplication and docs article/breadcrumb schemas. The docs route now includes last-modified metadata and schema output, with breadcrumb handling updated for non-linkable entries. It also removes standalone FAQ and roadmap pages in favor of docs routes, updates sitemap entries, adds legacy-to-docs redirects, and adds default OG and LLM discovery files in `public`.

Author: ProgrammerNomad

app/changelog/page.tsx

@@ -3,10 +3,13 @@ import Link from "next/link";
 import { MarkdownPage } from "@/components/markdown-page";
 import { readRootMarkdown } from "@/lib/markdown";
 
-export const metadata: Metadata = {
+import { buildPageMetadata } from "@/lib/page-metadata";
+
+export const metadata: Metadata = buildPageMetadata({
+  path: "/changelog",
   title: "Changelog",
   description: "DevStackBox release history and notable changes.",
-};
+});
 
 export default function ChangelogPage() {
   const markdown = readRootMarkdown("CHANGELOG.md");

app/community/page.tsx

@@ -4,10 +4,13 @@ import { MarkdownPageSimple } from "@/components/markdown-page";
 import { siteConfig } from "@/content/homepage";
 import { readRootMarkdown } from "@/lib/markdown";
 
-export const metadata: Metadata = {
+import { buildPageMetadata } from "@/lib/page-metadata";
+
+export const metadata: Metadata = buildPageMetadata({
+  path: "/community",
   title: "Community",
   description: "Join the DevStackBox open-source community.",
-};
+});
 
 export default function CommunityPage() {
   const coc = readRootMarkdown("CODE_OF_CONDUCT.md");

app/docs/[[...slug]]/page.tsx

@@ -2,13 +2,16 @@ import type { Metadata } from "next";
 import Link from "next/link";
 import { notFound } from "next/navigation";
 import { DocPageActions } from "@/components/doc-page-actions";
+import { JsonLd } from "@/components/json-ld";
 import {
   DocsSidebar,
   getBreadcrumbs,
   getPrevNext,
 } from "@/components/docs-sidebar";
-import { getLastUpdated } from "@/lib/git-meta";
+import { getLastModifiedIso, getLastUpdated } from "@/lib/git-meta";
+import { docPageMetadata } from "@/lib/page-metadata";
 import { source } from "@/lib/source";
+import { docPageSchemas } from "@/lib/structured-data";
 import { getMDXComponents } from "@/mdx-components";
 
 type PageProps = {
@@ -28,20 +31,34 @@ export default async function DocPage(props: PageProps) {
   const { prev, next } = getPrevNext(activeSlug);
   const crumbs = getBreadcrumbs(activeSlug);
   const mdxPath = activeSlug ? `docs/${activeSlug}.mdx` : "docs/index.mdx";
+  const modifiedIso = getLastModifiedIso(mdxPath);
 
   return (
     <div className="grid gap-8 lg:grid-cols-[240px_1fr]">
+      <JsonLd
+        data={docPageSchemas({
+          slug: activeSlug,
+          title: page.data.title,
+          description: page.data.description,
+          crumbs,
+          modifiedTime: modifiedIso,
+        })}
+      />
       <aside className="hidden lg:block">
         <DocsSidebar activeSlug={activeSlug} />
       </aside>
       <article className="min-w-0 max-w-3xl">
         <nav className="mb-4 flex flex-wrap items-center gap-1 text-sm text-muted-foreground">
           {crumbs.map((c, i) => (
-            <span key={c.href} className="flex items-center gap-1">
+            <span key={`${c.label}-${i}`} className="flex items-center gap-1">
               {i > 0 ? <span>/</span> : null}
-              <Link href={c.href} className="hover:text-foreground">
-                {c.label}
-              </Link>
+              {c.href ? (
+                <Link href={c.href} className="hover:text-foreground">
+                  {c.label}
+                </Link>
+              ) : (
+                <span>{c.label}</span>
+              )}
             </span>
           ))}
         </nav>
@@ -78,13 +95,12 @@ export async function generateMetadata(props: PageProps): Promise<Metadata> {
     source.getPage(slug) ??
     (slug.length === 0 ? source.getPage(["index"]) : undefined);
   if (!page) return {};
-  return {
+  const activeSlug = slug.join("/");
+  const mdxPath = activeSlug ? `docs/${activeSlug}.mdx` : "docs/index.mdx";
+  return docPageMetadata({
+    slug: activeSlug,
     title: page.data.title,
     description: page.data.description,
-    openGraph: {
-      title: `${page.data.title} · DevStackBox`,
-      description: page.data.description,
-      type: "article",
-    },
-  };
+    modifiedTime: getLastModifiedIso(mdxPath),
+  });
 }

app/download/page.tsx

@@ -8,10 +8,13 @@ import {
   getLatestRelease,
 } from "@/lib/github";
 
-export const metadata: Metadata = {
+import { buildPageMetadata } from "@/lib/page-metadata";
+
+export const metadata: Metadata = buildPageMetadata({
+  path: "/download",
   title: "Download",
   description: "Download the latest DevStackBox installer for Windows.",
-};
+});
 
 export default async function DownloadPage() {
   const release = await getLatestRelease();

app/faq/page.tsx

@@ -1,31 +1,29 @@
 import type { Metadata } from "next";
 import { RootProvider } from "fumadocs-ui/provider/next";
+import { JsonLd } from "@/components/json-ld";
 import { SiteFooter } from "@/components/site-footer";
 import { SiteHeader } from "@/components/site-header";
 import { siteConfig } from "@/content/homepage";
+import { buildPageMetadata, DEFAULT_OG_IMAGE } from "@/lib/page-metadata";
+import { websiteSchemas } from "@/lib/structured-data";
 import "./globals.css";
 
 export const metadata: Metadata = {
-  metadataBase: new URL(siteConfig.url),
+  ...buildPageMetadata({
+    path: "/",
+    description:
+      "Apache, PHP, MySQL and phpMyAdmin in one free, open-source desktop application for Windows. No telemetry. No cloud dependency.",
+  }),
   title: {
     default: "DevStackBox - Modern local PHP development for Windows",
     template: "%s · DevStackBox",
   },
-  description:
-    "Apache, PHP, MySQL and phpMyAdmin in one free, open-source desktop application for Windows. No telemetry. No cloud dependency.",
+  metadataBase: new URL(siteConfig.url),
   openGraph: {
     type: "website",
     locale: "en_US",
-    url: siteConfig.url,
     siteName: siteConfig.name,
-    description:
-      "Apache, PHP, MySQL and phpMyAdmin in one free, open-source desktop application for Windows.",
-  },
-  twitter: {
-    card: "summary_large_image",
-    title: siteConfig.name,
-    description:
-      "Apache, PHP, MySQL and phpMyAdmin in one free, open-source desktop application for Windows.",
+    images: [{ url: DEFAULT_OG_IMAGE, width: 1200, height: 630, alt: siteConfig.name }],
   },
 };
 
@@ -37,26 +35,12 @@ export default function RootLayout({
   return (
     <html lang="en" suppressHydrationWarning>
       <body className="flex min-h-screen flex-col bg-background font-sans text-foreground antialiased">
+        <JsonLd data={websiteSchemas()} />
         <RootProvider>
           <SiteHeader />
           <main className="flex-1">{children}</main>
           <SiteFooter />
         </RootProvider>
-        <script
-          type="application/ld+json"
-          dangerouslySetInnerHTML={{
-            __html: JSON.stringify({
-              "@context": "https://schema.org",
-              "@type": "SoftwareApplication",
-              name: "DevStackBox",
-              applicationCategory: "DeveloperApplication",
-              operatingSystem: "Windows 10, Windows 11",
-              offers: { "@type": "Offer", price: "0", priceCurrency: "USD" },
-              url: siteConfig.url,
-              downloadUrl: `${siteConfig.url}/download`,
-            }),
-          }}
-        />
       </body>
     </html>
   );

app/layout.tsx

@@ -2,10 +2,13 @@ import type { Metadata } from "next";
 import { MarkdownPage } from "@/components/markdown-page";
 import { readRootMarkdown } from "@/lib/markdown";
 
-export const metadata: Metadata = {
+import { buildPageMetadata } from "@/lib/page-metadata";
+
+export const metadata: Metadata = buildPageMetadata({
+  path: "/license",
   title: "License",
   description: "DevStackBox is released under the MIT License.",
-};
+});
 
 export default function LicensePage() {
   return (

app/license/page.tsx

@@ -2,10 +2,13 @@ import type { Metadata } from "next";
 import { MarkdownPage } from "@/components/markdown-page";
 import { readRootMarkdown } from "@/lib/markdown";
 
-export const metadata: Metadata = {
+import { buildPageMetadata } from "@/lib/page-metadata";
+
+export const metadata: Metadata = buildPageMetadata({
+  path: "/privacy",
   title: "Privacy",
   description: "DevStackBox privacy policy - no telemetry, local-first.",
-};
+});
 
 export default function PrivacyPage() {
   return (

app/privacy/page.tsx

@@ -2,10 +2,13 @@ import type { Metadata } from "next";
 import Link from "next/link";
 import { formatReleaseDate, getReleases } from "@/lib/github";
 
-export const metadata: Metadata = {
+import { buildPageMetadata } from "@/lib/page-metadata";
+
+export const metadata: Metadata = buildPageMetadata({
+  path: "/releases",
   title: "Releases",
   description: "DevStackBox release history and downloads.",
-};
+});
 
 export default async function ReleasesPage() {
   const releases = await getReleases(30);