docs: add PostHog analytics + fix navbar primary href

[soleil-colza]

Summary

• Add PostHog integration to docs/docs.json so docs page views land in the same PostHog project as arkor.ai and Studio. One event stream across all surfaces; filter by \$current_url if separation is needed
• sessionRecording: false. The visitor click/scroll capture is overkill for public docs, and keeps storage / privacy surface area down
• Restore leading slash on navbar.primary.href (/quickstart). Mintlify's local validator rejects bare quickstart with "Must be a valid URL or relative path". Now that we publish at docs.arkor.ai (subdomain, not arkor.ai/docs subpath), an absolute path stays inside the docs site so the original form is fine

Test plan

• pnpm --filter @arkor/docs exec mint validate passes locally
• After merge, PostHog dashboard receives \$pageview events from docs.arkor.ai (or the Mintlify preview URL)

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
arkor-92aeef0e	🟢 Ready	View Preview	Apr 29, 2026, 8:00 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[greptile-apps]

Greptile Summary

This PR makes two targeted changes to docs/docs.json: it adds a PostHog analytics integration block (with session recording disabled) and restores the leading slash on navbar.primary.href so Mintlify's validator accepts it as a valid relative path. Both changes are correct and consistent with the described intent.

Confidence Score: 5/5

Safe to merge — changes are a config-only addition with no logic impact.

Both changes are correct: the PostHog phc_ key is a public client-side ingestion key by design (not a secret), session recording is explicitly disabled, and the /quickstart path fix aligns with Mintlify's validator requirements. No P0/P1 findings.

No files require special attention.

Important Files Changed

Filename	Overview
docs/docs.json	Adds PostHog analytics integration (client-side phc_ key, session recording disabled) and restores the leading slash on navbar.primary.href.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["docs.arkor.ai page load"] --> B["Mintlify runtime"]
    B --> C["PostHog JS snippet\n(phc_ project key)"]
    C --> D["PostHog Cloud\n$pageview event"]
    B --> E["navbar 'Get started' button\nhref: /quickstart"]
    E --> F["docs.arkor.ai/quickstart"]

Loading

_{Reviews (1): Last reviewed commit: "docs: add PostHog analytics integration" | Re-trigger Greptile}

[Copilot]

Pull request overview

Updates the Mintlify docs configuration to align navigation validation requirements and to send docs pageview analytics into the existing PostHog project used by other Arkor surfaces.

Changes:

• Fix navbar.primary.href to use an absolute path (/quickstart) to satisfy Mintlify validation.
• Add a Mintlify integrations.posthog configuration with sessionRecording: false.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.