feat(site): add PostHog analytics to landing and docs pages

.github/workflows/site.yml

@@ -0,0 +1,42 @@
+name: Deploy site
+
+on:
+  push:
+    branches: [main]
+    paths: ["site/**", ".github/workflows/site.yml"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: deploy-site
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: site/package-lock.json
+
+      - name: Install
+        working-directory: site
+        run: npm ci
+
+      - name: Build
+        working-directory: site
+        env:
+          PUBLIC_POSTHOG_KEY: ${{ vars.PUBLIC_POSTHOG_KEY }}
+        run: npm run build
+
+      - name: Deploy
+        working-directory: site
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+        run: npx wrangler deploy

site/astro.config.mjs

@@ -12,6 +12,8 @@ export default defineConfig({
         "Write an AI coding skill once, run it in every AI coding assistant.",
       logo: { src: "./src/assets/logo-mark.svg", alt: "adeptability" },
       favicon: "/favicon.svg",
+      // Head override adds the bundled PostHog script to every docs page.
+      components: { Head: "./src/components/Head.astro" },
       // Gold accent retheme, matching the landing page + neon-gold logo.
       customCss: ["./src/styles/starlight-gold.css"],
       // Social preview image on every docs page. Starlight already emits

site/package.json

@@ -17,6 +17,7 @@
     "@fontsource/jetbrains-mono": "^5.3.0",
     "@fontsource/space-grotesk": "^5.3.0",
     "astro": "^7.1.3",
+    "posthog-js": "^1.407.2",
     "sharp": "^0.33.5"
   },
   "devDependencies": {

site/src/components/Head.astro

@@ -0,0 +1,10 @@
+---
+// Starlight Head override: default head plus the bundled PostHog script,
+// so every docs page ships analytics without an external snippet.
+import Default from '@astrojs/starlight/components/Head.astro';
+---
+
+<Default><slot /></Default>
+<script>
+  import '../scripts/analytics';
+</script>

site/src/pages/index.astro

@@ -83,6 +83,11 @@ const jsonLd = {
 
     <!-- Structured data (JSON-LD) -->
     <script type="application/ld+json" set:html={JSON.stringify(jsonLd)} />
+
+    <!-- PostHog analytics (bundled from npm; key injected at build time) -->
+    <script>
+      import '../scripts/analytics';
+    </script>
   </head>
   <body>
     <a class="skip-link" href="#main">Skip to content</a>

site/src/scripts/analytics.ts

@@ -0,0 +1,12 @@
+// PostHog analytics, bundled from npm (no external script load).
+// The key is injected at build time from PUBLIC_POSTHOG_KEY (site/.env
+// locally, a GitHub Actions variable in CI). No key = analytics off.
+import posthog from 'posthog-js';
+
+const key = import.meta.env.PUBLIC_POSTHOG_KEY;
+if (key) {
+  posthog.init(key, {
+    api_host: 'https://us.i.posthog.com',
+    defaults: '2025-05-24',
+  });
+}