doccupine 0.0.70 → 0.0.71

package/README.md

@@ -135,6 +135,7 @@ Place these JSON files in your project root (where you run `doccupine`). They ar
 | `links.json`      | Static header/footer links                                                                                |
 | `fonts.json`      | Font configuration (Google Fonts or local)                                                                |
 | `sections.json`   | Section definitions for tabbed doc groups (see [Sections](#sections))                                     |
+| `analytics.json`  | Analytics provider configuration (PostHog supported)                                                      |
 
 ## Public Directory
 

package/dist/lib/structures.js

@@ -96,6 +96,7 @@ import { platformThemeSettingsMdxTemplate } from "../templates/mdx/platform/them
 import { platformNavigationSettingsMdxTemplate } from "../templates/mdx/platform/navigation-settings.mdx.js";
 import { platformFontsSettingsMdxTemplate } from "../templates/mdx/platform/fonts-settings.mdx.js";
 import { platformExternalLinksMdxTemplate } from "../templates/mdx/platform/external-links.mdx.js";
+import { platformAnalyticsMdxTemplate } from "../templates/mdx/platform/analytics.mdx.js";
 import { platformAiAssistantMdxTemplate } from "../templates/mdx/platform/ai-assistant.mdx.js";
 import { platformCustomDomainsMdxTemplate } from "../templates/mdx/platform/custom-domains.mdx.js";
 import { platformBuildAndDeployMdxTemplate } from "../templates/mdx/platform/build-and-deploy.mdx.js";
@@ -203,6 +204,7 @@ export const startingDocsStructure = {
     "platform/navigation-settings.mdx": platformNavigationSettingsMdxTemplate,
     "platform/fonts-settings.mdx": platformFontsSettingsMdxTemplate,
     "platform/external-links.mdx": platformExternalLinksMdxTemplate,
+    "platform/analytics.mdx": platformAnalyticsMdxTemplate,
     "platform/ai-assistant.mdx": platformAiAssistantMdxTemplate,
     "platform/custom-domains.mdx": platformCustomDomainsMdxTemplate,
     "platform/build-and-deploy.mdx": platformBuildAndDeployMdxTemplate,

package/dist/templates/components/PostHogProvider.d.ts

@@ -1 +1 @@
-export declare const postHogProviderTemplate = "\"use client\";\n\nimport posthog from \"posthog-js\";\nimport { PostHogProvider as PHProvider } from \"posthog-js/react\";\nimport { Suspense, useEffect, useRef, useState } from \"react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport rawAnalyticsConfig from \"@/analytics.json\";\n\ninterface AnalyticsConfig {\n  provider?: string;\n  posthog?: {\n    key?: string;\n    host?: string;\n  };\n}\n\nconst analyticsConfig = rawAnalyticsConfig as AnalyticsConfig;\n\nconst posthogKey =\n  analyticsConfig?.provider === \"posthog\" ? analyticsConfig.posthog?.key : null;\n\nfunction PostHogInit({ onReady }: { onReady: () => void }) {\n  const initRef = useRef(false);\n\n  useEffect(() => {\n    if (initRef.current || !posthogKey) return;\n    initRef.current = true;\n\n    posthog.init(posthogKey, {\n      api_host: \"/ingest\",\n      ui_host: analyticsConfig.posthog?.host || \"https://us.posthog.com\",\n      capture_pageview: false,\n      capture_pageleave: true,\n      loaded: onReady,\n    });\n  }, [onReady]);\n\n  return null;\n}\n\nfunction PostHogPageviewTracker() {\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n\n  useEffect(() => {\n    if (pathname) {\n      const url = searchParams?.size\n        ? `${pathname}?${searchParams.toString()}`\n        : pathname;\n      posthog.capture(\"$pageview\", { $current_url: url });\n    }\n  }, [pathname, searchParams]);\n\n  return null;\n}\n\nexport function PostHogProvider({ children }: { children: React.ReactNode }) {\n  const [ready, setReady] = useState(false);\n\n  if (!posthogKey) {\n    return <>{children}</>;\n  }\n\n  return (\n    <PHProvider client={posthog}>\n      <PostHogInit onReady={() => setReady(true)} />\n      <Suspense fallback={null}>{ready && <PostHogPageviewTracker />}</Suspense>\n      {children}\n    </PHProvider>\n  );\n}\n";
+export declare const postHogProviderTemplate = "\"use client\";\n\nimport posthog from \"posthog-js\";\nimport { PostHogProvider as PHProvider } from \"@posthog/react\";\nimport { Suspense, useEffect, useRef, useState } from \"react\";\nimport { usePathname, useSearchParams } from \"next/navigation\";\nimport rawAnalyticsConfig from \"@/analytics.json\";\n\ninterface AnalyticsConfig {\n  provider?: string;\n  posthog?: {\n    key?: string;\n    host?: string;\n  };\n}\n\nconst analyticsConfig = rawAnalyticsConfig as AnalyticsConfig;\n\nconst posthogKey =\n  analyticsConfig?.provider === \"posthog\" ? analyticsConfig.posthog?.key : null;\n\nfunction PostHogInit({ onReady }: { onReady: () => void }) {\n  const initRef = useRef(false);\n\n  useEffect(() => {\n    if (initRef.current || !posthogKey) return;\n    initRef.current = true;\n\n    posthog.init(posthogKey, {\n      api_host: \"/ingest\",\n      ui_host: analyticsConfig.posthog?.host || \"https://us.posthog.com\",\n      capture_pageview: false,\n      capture_pageleave: true,\n      loaded: onReady,\n    });\n  }, [onReady]);\n\n  return null;\n}\n\nfunction PostHogPageviewTracker() {\n  const pathname = usePathname();\n  const searchParams = useSearchParams();\n\n  useEffect(() => {\n    if (pathname) {\n      const url = searchParams?.size\n        ? `${pathname}?${searchParams.toString()}`\n        : pathname;\n      posthog.capture(\"$pageview\", { $current_url: url });\n    }\n  }, [pathname, searchParams]);\n\n  return null;\n}\n\nexport function PostHogProvider({ children }: { children: React.ReactNode }) {\n  const [ready, setReady] = useState(false);\n\n  if (!posthogKey) {\n    return <>{children}</>;\n  }\n\n  return (\n    <PHProvider client={posthog}>\n      <PostHogInit onReady={() => setReady(true)} />\n      <Suspense fallback={null}>{ready && <PostHogPageviewTracker />}</Suspense>\n      {children}\n    </PHProvider>\n  );\n}\n";

package/dist/templates/components/PostHogProvider.js

@@ -1,7 +1,7 @@
 export const postHogProviderTemplate = `"use client";
 
 import posthog from "posthog-js";
-import { PostHogProvider as PHProvider } from "posthog-js/react";
+import { PostHogProvider as PHProvider } from "@posthog/react";
 import { Suspense, useEffect, useRef, useState } from "react";
 import { usePathname, useSearchParams } from "next/navigation";
 import rawAnalyticsConfig from "@/analytics.json";

package/dist/templates/mdx/platform/analytics.mdx.d.ts

@@ -0,0 +1 @@
+export declare const platformAnalyticsMdxTemplate = "---\ntitle: \"Analytics\"\ndescription: \"Enable PostHog analytics to track page views on your documentation site.\"\ndate: \"2026-02-24\"\ncategory: \"Configuration\"\ncategoryOrder: 2\norder: 3\nsection: \"Platform\"\n---\n# Analytics\nThe Analytics settings page lets you add PostHog analytics to your documentation site. Page views are tracked client-side and proxied through your own domain for privacy - no data is sent directly to PostHog.\n\n## Enabling analytics\nUse the **Enable Analytics** toggle to turn tracking on or off. When disabled, no tracking code is added to your site.\n\n## Configuration\n\n### PostHog Project API Key\nYour project API key from PostHog (starts with `phc_`). This is a public identifier and is safe to commit to your repository.\n\nTo find your key:\n1. Log in to [PostHog](https://posthog.com).\n2. Open your project settings.\n3. Copy the **Project API Key**.\n\n### Region\nSelect the PostHog cloud region that matches your project:\n\n- **US Cloud** - `us.i.posthog.com`\n- **EU Cloud** - `eu.i.posthog.com`\n\n## How it works\nAnalytics settings are stored in `analytics.json` at the root of your repository. Here's an example:\n\n```json\n{\n  \"provider\": \"posthog\",\n  \"posthog\": {\n    \"key\": \"phc_your_project_api_key\",\n    \"host\": \"https://us.i.posthog.com\"\n  }\n}\n```\n\nWhen enabled, Doccupine routes all analytics traffic through your documentation domain using Next.js rewrites. Instead of sending data directly to PostHog (which ad blockers may intercept), requests go through `/ingest` on your own domain and are proxied to PostHog.\n\n<Callout type=\"note\">\n  Changes to analytics settings are staged as pending changes. Click **Publish** to commit them to your repository and trigger a deploy.\n</Callout>\n\nSee the [Analytics](/analytics) page for the full configuration reference and additional details on the privacy proxy.";

package/dist/templates/mdx/platform/analytics.mdx.js

@@ -0,0 +1,51 @@
+export const platformAnalyticsMdxTemplate = `---
+title: "Analytics"
+description: "Enable PostHog analytics to track page views on your documentation site."
+date: "2026-02-24"
+category: "Configuration"
+categoryOrder: 2
+order: 3
+section: "Platform"
+---
+# Analytics
+The Analytics settings page lets you add PostHog analytics to your documentation site. Page views are tracked client-side and proxied through your own domain for privacy - no data is sent directly to PostHog.
+
+## Enabling analytics
+Use the **Enable Analytics** toggle to turn tracking on or off. When disabled, no tracking code is added to your site.
+
+## Configuration
+
+### PostHog Project API Key
+Your project API key from PostHog (starts with \`phc_\`). This is a public identifier and is safe to commit to your repository.
+
+To find your key:
+1. Log in to [PostHog](https://posthog.com).
+2. Open your project settings.
+3. Copy the **Project API Key**.
+
+### Region
+Select the PostHog cloud region that matches your project:
+
+- **US Cloud** - \`us.i.posthog.com\`
+- **EU Cloud** - \`eu.i.posthog.com\`
+
+## How it works
+Analytics settings are stored in \`analytics.json\` at the root of your repository. Here's an example:
+
+\`\`\`json
+{
+  "provider": "posthog",
+  "posthog": {
+    "key": "phc_your_project_api_key",
+    "host": "https://us.i.posthog.com"
+  }
+}
+\`\`\`
+
+When enabled, Doccupine routes all analytics traffic through your documentation domain using Next.js rewrites. Instead of sending data directly to PostHog (which ad blockers may intercept), requests go through \`/ingest\` on your own domain and are proxied to PostHog.
+
+<Callout type="note">
+  Changes to analytics settings are staged as pending changes. Click **Publish** to commit them to your repository and trigger a deploy.
+</Callout>
+
+See the [Analytics](/analytics) page for the full configuration reference and additional details on the privacy proxy.`;

package/dist/templates/package.js

@@ -10,20 +10,21 @@ export const packageJsonTemplate = JSON.stringify({
         format: "prettier --write .",
     },
     dependencies: {
-        "@langchain/anthropic": "^1.3.19",
-        "@langchain/core": "^1.1.27",
+        "@langchain/anthropic": "^1.3.20",
+        "@langchain/core": "^1.1.28",
         "@langchain/google-genai": "^2.1.20",
-        "@langchain/openai": "^1.2.9",
+        "@langchain/openai": "^1.2.10",
         "@mdx-js/react": "^3.1.1",
-        "@modelcontextprotocol/sdk": "^1.26.0",
+        "@modelcontextprotocol/sdk": "^1.27.1",
+        "@posthog/react": "^1.8.1",
         "cherry-styled-components": "^0.1.13",
-        langchain: "^1.2.25",
+        langchain: "^1.2.27",
         "lucide-react": "^0.575.0",
         next: "16.1.6",
         "next-mdx-remote": "^6.0.0",
         polished: "^4.3.1",
-        "posthog-js": "^1.353.0",
-        "posthog-node": "^5.25.0",
+        "posthog-js": "^1.354.0",
+        "posthog-node": "^5.26.0",
         react: "19.2.4",
         "react-dom": "19.2.4",
         "rehype-highlight": "^7.0.2",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "doccupine",
-  "version": "0.0.70",
+  "version": "0.0.71",
   "description": "Free and open-source documentation platform. Write MDX, get a production-ready site with AI chat, built-in components, and an MCP server - in one command.",
   "main": "dist/index.js",
   "bin": {