Add optional Google Analytics to docs

Author: terion-name

.github/workflows/docs.yml

@@ -26,6 +26,7 @@ jobs:
     runs-on: ubuntu-24.04
     env:
       TERRARIUM_DOCS_BASE: ${{ vars.TERRARIUM_DOCS_BASE || '/terrarium/' }}
+      TERRARIUM_DOCS_GA_ID: ${{ vars.TERRARIUM_DOCS_GA_ID }}
     steps:
       - name: Checkout
         uses: actions/checkout@v5

docs/.vitepress/config.mts

@@ -12,10 +12,36 @@ function resolveBase(): string {
   return withLeadingSlash.endsWith("/") ? withLeadingSlash : `${withLeadingSlash}/`;
 }
 
+function resolveGoogleAnalyticsHead() {
+  const googleAnalyticsId = process.env.TERRARIUM_DOCS_GA_ID?.trim();
+  if (!googleAnalyticsId) {
+    return [];
+  }
+
+  return [
+    [
+      "script",
+      {
+        async: "",
+        src: `https://www.googletagmanager.com/gtag/js?id=${encodeURIComponent(googleAnalyticsId)}`
+      }
+    ],
+    [
+      "script",
+      {},
+      `window.dataLayer = window.dataLayer || [];
+function gtag(){dataLayer.push(arguments);}
+gtag("js", new Date());
+gtag("config", ${JSON.stringify(googleAnalyticsId)});`
+    ]
+  ];
+}
+
 export default defineConfig({
   title: "Terrarium",
   description: "Secure, rewindable VPS environments for agents, dev tools, and isolated apps.",
   base: resolveBase(),
+  head: resolveGoogleAnalyticsHead(),
   cleanUrls: true,
   lastUpdated: true,
   themeConfig: {