From 003fa4e2522c9f52f6574625f788bded8f87302c Mon Sep 17 00:00:00 2001
From: alhendrickson <159636032+alhendrickson@users.noreply.github.com.>
Date: Wed, 11 Mar 2026 13:39:41 +0000
Subject: [PATCH 1/2] docs: Add posthog usage analytics

---
 docs/mkdocs.yml                               |  5 +++++
 .../integrations/analytics/custom.html        | 19 +++++++++++++++++++
 2 files changed, 24 insertions(+)
 create mode 100644 docs/overrides/partials/integrations/analytics/custom.html

diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index a21b3fc..b5895f8 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -3,6 +3,7 @@ site_url: http://localhost:8080/docs/
 
 theme:
   name: material
+  custom_dir: overrides
   favicon: assets/cogstack-logo.png
   logo: assets/cogstack-logo.png
   icon:
@@ -93,6 +94,10 @@ plugins:
   - search
   - termynal
 
+extra:
+  analytics:
+    provider: custom
+
 markdown_extensions:
   - admonition
   - attr_list
diff --git a/docs/overrides/partials/integrations/analytics/custom.html b/docs/overrides/partials/integrations/analytics/custom.html
new file mode 100644
index 0000000..73145b0
--- /dev/null
+++ b/docs/overrides/partials/integrations/analytics/custom.html
@@ -0,0 +1,19 @@
+{#-
+  PostHog analytics integration (custom provider).
+  Loads on every page; works with instant navigation via location$.
+-#}
+<script>
+  !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="init capture register register_once register_for_session unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled getFeatureFlag getFeatureFlagPayload reloadFeatureFlags group identify setPersonProperties setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags resetGroups onFeatureFlags addFeatureFlagsHandler onSessionId getSurveys getActiveMatchingSurveys renderSurvey canRenderSurvey getNextSurveyStep".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
+  posthog.init('phc_kCks07Y0m56WvCKnS4RjZ4bp3HePHkma8MvNmBFfPvL', {
+    api_host: 'https://b.cogstack.org',
+    ui_host: 'https://eu.posthog.com',
+    defaults: '2026-01-30'
+  });
+  document.addEventListener("DOMContentLoaded", function() {
+    if (typeof location$ !== "undefined") {
+      location$.subscribe(function(url) {
+        if (window.posthog) posthog.capture("$pageview", { $current_url: url.href });
+      });
+    }
+  });
+</script>

From 545a7ca9dbe1942136e6ba965d7cc2782ff92e65 Mon Sep 17 00:00:00 2001
From: alhendrickson <159636032+alhendrickson@users.noreply.github.com.>
Date: Thu, 19 Mar 2026 10:41:18 +0000
Subject: [PATCH 2/2] docs: Set cookieless mode for privacy

---
 docs/overrides/partials/integrations/analytics/custom.html | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/overrides/partials/integrations/analytics/custom.html b/docs/overrides/partials/integrations/analytics/custom.html
index 73145b0..52c41c6 100644
--- a/docs/overrides/partials/integrations/analytics/custom.html
+++ b/docs/overrides/partials/integrations/analytics/custom.html
@@ -5,6 +5,7 @@
 <script>
   !function(t,e){var o,n,p,r;e.__SV||(window.posthog=e,e._i=[],e.init=function(i,s,a){function g(t,e){var o=e.split(".");2==o.length&&(t=t[o[0]],e=o[1]),t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}}(p=t.createElement("script")).type="text/javascript",p.async=!0,p.src=s.api_host.replace(".i.posthog.com","-assets.i.posthog.com")+"/static/array.js",(r=t.getElementsByTagName("script")[0]).parentNode.insertBefore(p,r);var u=e;for(void 0!==a?u=e[a]=[]:a="posthog",u.people=u.people||[],u.toString=function(t){var e="posthog";return"posthog"!==a&&(e+="."+a),t||(e+=" (stub)"),e},u.people.toString=function(){return u.toString(1)+".people (stub)"},o="init capture register register_once register_for_session unregister opt_out_capturing has_opted_out_capturing opt_in_capturing reset isFeatureEnabled getFeatureFlag getFeatureFlagPayload reloadFeatureFlags group identify setPersonProperties setPersonPropertiesForFlags resetPersonPropertiesForFlags setGroupPropertiesForFlags resetGroupPropertiesForFlags resetGroups onFeatureFlags addFeatureFlagsHandler onSessionId getSurveys getActiveMatchingSurveys renderSurvey canRenderSurvey getNextSurveyStep".split(" "),n=0;n<o.length;n++)g(u,o[n]);e._i.push([i,s,a])},e.__SV=1)}(document,window.posthog||[]);
   posthog.init('phc_kCks07Y0m56WvCKnS4RjZ4bp3HePHkma8MvNmBFfPvL', {
+    cookieless_mode: 'always',
     api_host: 'https://b.cogstack.org',
     ui_host: 'https://eu.posthog.com',
     defaults: '2026-01-30'