From 271d9c4bc2c1d6b9db66cc09ba6a6ae5b2171bf2 Mon Sep 17 00:00:00 2001
From: Khuyen Tran <khuyentran@codecut.ai>
Date: Thu, 16 Apr 2026 10:05:52 +0700
Subject: [PATCH 1/2] feat(docs): add GA4 tracking with GDPR cookie consent
 banner

---
 .../layouts/partials/docs/inject/head.html    | 69 +++++++++++++++++++
 1 file changed, 69 insertions(+)

diff --git a/docs/site/layouts/partials/docs/inject/head.html b/docs/site/layouts/partials/docs/inject/head.html
index 3c04b44..cb55a52 100644
--- a/docs/site/layouts/partials/docs/inject/head.html
+++ b/docs/site/layouts/partials/docs/inject/head.html
@@ -1,2 +1,71 @@
 <link rel="stylesheet" href="{{ "css/custom.css" | relURL }}">
 <link rel="icon" type="image/svg+xml" href="{{ "images/skillsctl-icon.svg" | relURL }}">
+
+<script>
+  window.dataLayer = window.dataLayer || [];
+  function gtag(){dataLayer.push(arguments);}
+  gtag('consent', 'default', {
+    ad_storage: 'denied',
+    ad_user_data: 'denied',
+    ad_personalization: 'denied',
+    analytics_storage: 'denied',
+    functionality_storage: 'denied',
+    personalization_storage: 'denied',
+    security_storage: 'granted',
+    wait_for_update: 500
+  });
+  gtag('set', 'ads_data_redaction', true);
+  gtag('js', new Date());
+  gtag('config', 'G-NXNMX83GGS', { anonymize_ip: true });
+</script>
+<script async src="https://www.googletagmanager.com/gtag/js?id=G-NXNMX83GGS"></script>
+
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/vanilla-cookieconsent@3.1.0/dist/cookieconsent.css">
+<script src="https://cdn.jsdelivr.net/npm/vanilla-cookieconsent@3.1.0/dist/cookieconsent.umd.js"></script>
+<script>
+  const updateGtag = (granted) => {
+    window.dataLayer = window.dataLayer || [];
+    window.dataLayer.push(['consent', 'update', {
+      analytics_storage: granted ? 'granted' : 'denied',
+    }]);
+  };
+
+  CookieConsent.run({
+    guiOptions: {
+      consentModal: { layout: 'box', position: 'bottom right' },
+      preferencesModal: { layout: 'box' },
+    },
+    categories: {
+      necessary: { enabled: true, readOnly: true },
+      analytics: {},
+    },
+    language: {
+      default: 'en',
+      translations: {
+        en: {
+          consentModal: {
+            title: 'Cookie Consent',
+            description: 'We use cookies to analyze site traffic and improve your experience.',
+            acceptAllBtn: 'Accept all',
+            acceptNecessaryBtn: 'Reject all',
+            showPreferencesBtn: 'Manage preferences',
+          },
+          preferencesModal: {
+            title: 'Cookie preferences',
+            acceptAllBtn: 'Accept all',
+            acceptNecessaryBtn: 'Reject all',
+            savePreferencesBtn: 'Save preferences',
+            closeIconLabel: 'Close',
+            sections: [
+              { title: 'Strictly necessary', description: 'Essential for the site to function.', linkedCategory: 'necessary' },
+              { title: 'Analytics', description: 'Help us understand how visitors use the site.', linkedCategory: 'analytics' },
+            ],
+          },
+        },
+      },
+    },
+    onFirstConsent: () => updateGtag(CookieConsent.acceptedCategory('analytics')),
+    onChange: () => updateGtag(CookieConsent.acceptedCategory('analytics')),
+    onConsent: () => updateGtag(CookieConsent.acceptedCategory('analytics')),
+  });
+</script>

From 016292207415336f8343e1ff497c73ebb2e73991 Mon Sep 17 00:00:00 2001
From: Khuyen Tran <khuyentran@codecut.ai>
Date: Thu, 16 Apr 2026 10:16:01 +0700
Subject: [PATCH 2/2] fix(docs): init cookie consent on DOMContentLoaded

---
 docs/site/layouts/partials/docs/inject/head.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/site/layouts/partials/docs/inject/head.html b/docs/site/layouts/partials/docs/inject/head.html
index cb55a52..73b787e 100644
--- a/docs/site/layouts/partials/docs/inject/head.html
+++ b/docs/site/layouts/partials/docs/inject/head.html
@@ -30,7 +30,7 @@
     }]);
   };
 
-  CookieConsent.run({
+  window.addEventListener('DOMContentLoaded', () => CookieConsent.run({
     guiOptions: {
       consentModal: { layout: 'box', position: 'bottom right' },
       preferencesModal: { layout: 'box' },
@@ -67,5 +67,5 @@
     onFirstConsent: () => updateGtag(CookieConsent.acceptedCategory('analytics')),
     onChange: () => updateGtag(CookieConsent.acceptedCategory('analytics')),
     onConsent: () => updateGtag(CookieConsent.acceptedCategory('analytics')),
-  });
+  }));
 </script>