diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index 4c4b875a..7f40449c 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -245,12 +245,13 @@ const config: Config = {
     // },
   } satisfies Preset.ThemeConfig,
 
+  // Migrated legacy setting to markdown.hooks.onBrokenMarkdownLinks
   markdown: {
     mermaid: true,
+    // ✅ CORRECT for Docusaurus 3.9+
+    hooks: { onBrokenMarkdownLinks: "warn" },
   },
 
-  // Migrated legacy setting to markdown.hooks.onBrokenMarkdownLinks
-
   themes: ["@docusaurus/theme-mermaid"],
 
   plugins: [
@@ -268,16 +269,14 @@ const config: Config = {
 
   // ✅ Add this customFields object to expose the token to the client-side
   customFields: {
-    gitToken: process.env.DOCUSAURUS_GIT_TOKEN,
+    gitToken: process.env.GITHUB_TOKEN || process.env.DOCUSAURUS_GIT_TOKEN,
+
     // Shopify credentials for merch store
     SHOPIFY_STORE_DOMAIN:
       process.env.SHOPIFY_STORE_DOMAIN || "junh9v-gw.myshopify.com",
     SHOPIFY_STOREFRONT_ACCESS_TOKEN:
       process.env.SHOPIFY_STOREFRONT_ACCESS_TOKEN ||
       "2503dfbf93132b42e627e7d53b3ba3e9",
-    hooks: {
-      onBrokenMarkdownLinks: "warn",
-    },
   },
 };