feat: centralize site URL management with SITE_URL and absoluteUrl functions

Author: spivx

app/layout.tsx

@@ -5,6 +5,7 @@ import { Geist, Geist_Mono } from "next/font/google";
 import "./globals.css";
 import { ThemeProvider } from "@/components/theme-provider";
 import { MixpanelInit } from "@/components/MixpanelInit";
+import { SITE_URL } from "@/lib/site-metadata";
 
 const geistSans = Geist({
   variable: "--font-geist-sans",
@@ -16,7 +17,7 @@ const geistMono = Geist_Mono({
   subsets: ["latin"],
 });
 
-const siteUrl = "https://devcontext.xyz";
+const siteUrl = SITE_URL;
 const siteTitle = "DevContext – AI Coding Guidelines & Repo Analyzer";
 const siteDescription =
   "DevContext helps developers generate AI config files like Copilot instructions, Cursor rules, and agents.md. Start fresh with a guided wizard or analyze your GitHub repo to auto-detect stack, frameworks, and best practices — consistent, fast, and IDE-ready.";

app/robots.ts

@@ -1,14 +1,14 @@
 import type { MetadataRoute } from "next";
 
-const baseUrl = "https://devcontext.com";
+import { SITE_URL, absoluteUrl } from "@/lib/site-metadata";
 
 export default function robots(): MetadataRoute.Robots {
   return {
     rules: {
       userAgent: "*",
       allow: "/",
     },
-    host: baseUrl,
-    sitemap: `${baseUrl}/sitemap.xml`,
+    host: SITE_URL,
+    sitemap: absoluteUrl("/sitemap.xml"),
   };
 }

app/sitemap.ts

@@ -2,8 +2,7 @@ import type { MetadataRoute } from "next"
 
 import stacksData from "@/data/stacks.json"
 import type { DataQuestionSource } from "@/types/wizard"
-
-const baseUrl = "https://devcontext.com"
+import { absoluteUrl } from "@/lib/site-metadata"
 
 const STATIC_ENTRIES: Array<{
   path: string
@@ -48,7 +47,7 @@ export default function sitemap(): MetadataRoute.Sitemap {
   ])
 
   return [...STATIC_ENTRIES, ...stackEntries].map(({ path, priority, changeFrequency }) => ({
-    url: `${baseUrl}${path}`,
+    url: absoluteUrl(path),
     priority,
     changeFrequency,
     lastModified,

app/stacks/[stack]/page.tsx

@@ -4,6 +4,7 @@ import { notFound } from "next/navigation"
 
 import stacksData from "@/data/stacks.json"
 import type { DataQuestionSource } from "@/types/wizard"
+import { absoluteUrl } from "@/lib/site-metadata"
 
 const stackQuestionSet = stacksData as DataQuestionSource[]
 const stackQuestion = stackQuestionSet[0]
@@ -120,7 +121,7 @@ export function generateMetadata({ params }: { params: { stack: string } }): Met
     title,
     description,
     alternates: {
-      canonical: `https://devcontext.xyz/stacks/${slug}`,
+      canonical: absoluteUrl(`/stacks/${slug}`),
     },
   }
 }

lib/site-metadata.ts

@@ -0,0 +1,23 @@
+const DEFAULT_SITE_URL = "https://www.devcontext.xyz";
+
+const normalizeSiteUrl = (input: string): string => {
+  const trimmed = input.trim();
+  if (!trimmed) {
+    return DEFAULT_SITE_URL;
+  }
+
+  const withoutTrailingSlash = trimmed.endsWith("/") ? trimmed.slice(0, -1) : trimmed;
+  return withoutTrailingSlash || DEFAULT_SITE_URL;
+};
+
+export const SITE_URL = normalizeSiteUrl(
+  process.env.NEXT_PUBLIC_SITE_URL ?? process.env.SITE_URL ?? DEFAULT_SITE_URL,
+);
+
+export const absoluteUrl = (path = ""): string => {
+  if (!path || path === "/") {
+    return SITE_URL;
+  }
+
+  return `${SITE_URL}${path.startsWith("/") ? path : `/${path}`}`;
+};