From d2eaeb3e34a75a9f964f05556e12d28dba20fd9c Mon Sep 17 00:00:00 2001
From: DaKheera47 <shaheergoodboy@gmail.com>
Date: Mon, 16 Feb 2026 01:07:42 +0000
Subject: [PATCH] env driven base url for docs

---
 docs-site/README.md            | 14 ++++++++++++++
 docs-site/docusaurus.config.ts | 13 +++++++++++--
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/docs-site/README.md b/docs-site/README.md
index b8d0e15..aa368e5 100644
--- a/docs-site/README.md
+++ b/docs-site/README.md
@@ -22,6 +22,20 @@ Build output:
 
 - `docs-site/build`
 
+## Configuration
+
+Set these environment variables for deploys:
+
+- `DOCS_SITE_URL`: Public origin for canonical/sitemap URLs.
+  Example: `https://jobops.dakheera47.com`
+- `DOCS_BASE_URL`: Route prefix where docs are hosted.
+  Example: `/docs/`
+
+Defaults (local development):
+
+- `DOCS_SITE_URL=http://localhost:3006`
+- `DOCS_BASE_URL=/docs/`
+
 ## Versioning
 
 Cut a docs version tied to a release tag:
diff --git a/docs-site/docusaurus.config.ts b/docs-site/docusaurus.config.ts
index f1bd02b..11ee18c 100644
--- a/docs-site/docusaurus.config.ts
+++ b/docs-site/docusaurus.config.ts
@@ -2,6 +2,15 @@ import type * as Preset from "@docusaurus/preset-classic";
 import type { Config } from "@docusaurus/types";
 import { themes as prismThemes } from "prism-react-renderer";
 
+const siteUrl = process.env.DOCS_SITE_URL ?? "http://localhost:3006";
+const configuredBaseUrl = process.env.DOCS_BASE_URL ?? "/docs/";
+const normalizedBaseUrl = configuredBaseUrl.startsWith("/")
+  ? configuredBaseUrl
+  : `/${configuredBaseUrl}`;
+const siteBaseUrl = normalizedBaseUrl.endsWith("/")
+  ? normalizedBaseUrl
+  : `${normalizedBaseUrl}/`;
+
 const config: Config = {
   title: "JobOps Documentation",
   tagline: "Self-hosted job search automation docs",
@@ -9,8 +18,8 @@ const config: Config = {
   future: {
     v4: true,
   },
-  url: "http://localhost:3005",
-  baseUrl: "/docs/",
+  url: siteUrl,
+  baseUrl: siteBaseUrl,
   onBrokenLinks: "throw",
   markdown: {
     hooks: {