Restructure documentation navigation

analytics/third-party-integrations.mdx

@@ -0,0 +1,84 @@
+---
+title: "Third-party analytics integrations"
+description: "Connect Helium with your analytics platforms"
+---
+
+Helium can forward paywall events to your existing analytics platforms so you can track paywall performance alongside the rest of your product data — without writing any additional instrumentation code.
+
+---
+
+### **Supported Platforms**
+
+| Platform      | Description                                                                                                       |
+| :------------ | :---------------------------------------------------------------------------------------------------------------- |
+| **Mixpanel**  | Paywall events appear as Mixpanel events, tied to user identity. Build funnels from paywall open to subscription. |
+| **Amplitude** | Paywall events flow into Amplitude for behavioral analysis and cohort building.                                   |
+| **PostHog**   | Paywall events as PostHog events, useful for product analytics and session replay correlation.                    |
+| **Statsig**   | Paywall events forwarded to Statsig for feature flag analysis and experimentation.                                |
+
+You can connect **multiple platforms at the same time**. Events are sent to all connected destinations simultaneously.
+
+---
+
+### **How It Works**
+
+1. The **Helium SDK** captures paywall interactions in your app.
+2. Events are sent to Helium's event pipeline (a Segment-compatible layer).
+3. The pipeline **routes events** to Helium's own analytics (for your dashboard metrics) _and_ to any third-party destinations you've configured.
+
+Once connected, forwarding is fully automatic. No SDK changes or additional code required.
+
+---
+
+### **Events Forwarded**
+
+| Event                          | When it fires                                                   |
+| :----------------------------- | :-------------------------------------------------------------- |
+| helium_paywallOpen             | A paywall is displayed to the user.                             |
+| helium_paywallDismissed        | The user dismisses the paywall.                                 |
+| helium_subscriptionPressed     | The user taps the subscribe button.                             |
+| helium_subscriptionSucceeded   | The purchase completes successfully.                            |
+| helium_subscriptionFailed      | The purchase fails.                                             |
+| helium_subscriptionCanceled    | The user cancels during the purchase flow.                      |
+| helium_paywallsDownloadSuccess | The SDK successfully initializes and downloads paywall configs. |
+
+Each event includes contextual properties: paywall ID, paywall name, trigger name, experiment ID and variant (if applicable), device type, OS, and user identifiers.
+
+---
+
+### **Setup**
+
+<Steps>
+  <Step title="Go to Integrations → Analytics in the Helium dashboard">
+
+  </Step>
+  <Step title="Select a platform">
+
+  </Step>
+  <Step title="Enter your credentials:">
+    - **Mixpanel** — Project Token
+    - **Amplitude** — API Key
+    - **PostHog** — Project API Key and Host
+    - **Statsig** — Server Secret Key
+  </Step>
+  <Step title="Save. Events begin forwarding immediately">
+
+  </Step>
+</Steps>
+
+To disconnect, open the integration and remove it from the Integrations page. Forwarding stops right away.
+
+---
+
+### **Key Points**
+
+- **No SDK code changes needed** — connecting a destination in the dashboard is all it takes.
+
+
+- Events are forwarded **in real time** as they occur in the app.
+
+
+- **Fallback paywalls also send events** — the analytics configuration is embedded in the fallback bundle, so tracking works even when the paywall is served from cache.
+
+
+- Helium's own dashboard metrics are **not affected** by third-party integrations — they always use Helium's primary data pipeline regardless of what destinations are connected.

docs.json

@@ -9,65 +9,81 @@
   },
   "favicon": "/favicon.svg",
   "navigation": {
+    "global": {
+      "anchors": [
+        {
+          "anchor": "More Info",
+          "icon": "lightbulb",
+          "href": "https://tryhelium.com"
+        }
+      ]
+    },
     "groups": [
       {
-        "group": "Getting Started",
+        "group": "Introduction",
         "icon": "flag",
         "pages": [
-          "getting-started/introduction",
-          "getting-started/quickstart"
+          "introduction/introduction",
+          "introduction/quickstart"
         ]
       },
       {
         "group": "SDK Quickstarts",
         "icon": "code",
         "pages": [
-          "sdk/quickstart-ios",
-          "sdk/quickstart-android",
-          "sdk/quickstart-react-native",
-          "sdk/quickstart-flutter",
-          "sdk/helium-events"
+          "sdk-quickstarts/overview",
+          "sdk-quickstarts/i-os",
+          "sdk-quickstarts/android",
+          "sdk-quickstarts/react-native",
+          "sdk-quickstarts/flutter",
+          "sdk-quickstarts/feature-availability"
         ]
       },
       {
-        "group": "Guides",
-        "icon": "compass",
+        "group": "Primitives",
+        "icon": "cube",
         "pages": [
-          "guides/revenue-reporting",
-          "guides/fallback-bundle",
-          "guides/ways-to-show-paywall",
-          "guides/third-party-analytics",
-          "guides/custom-events",
-          "guides/storekit-testing"
+          {
+            "group": "Paywalls",
+            "pages": [
+              "primitives/paywalls",
+              "primitives/paywalls/localization",
+              "sdk-quickstarts/fallbacks"
+            ]
+          },
+          "primitives/workflows",
+          "primitives/triggers",
+          "primitives/experiments",
+          "primitives/audiences",
+          "primitives/product-buckets"
         ]
       },
       {
-        "group": "SDK Reference",
-        "icon": "book-open",
+        "group": "Events",
+        "icon": "chart-line",
         "pages": [
-          "sdk-reference/sdk-features",
-          "sdk-reference/fallback-causes"
+          "events/custom-paywall-events",
+          "events/revenue-tracking"
+        ]
+      },
+      {
+        "group": "Analytics",
+        "icon": "chart-bar",
+        "pages": [
+          "analytics/third-party-integrations"
         ]
       },
       {
         "group": "Migrations",
         "icon": "arrow-up-right-dots",
         "pages": [
+          "migrations/overview",
           "migrations/ios-3-to-4",
           "migrations/android-0-to-4",
           "migrations/ios-2-to-3"
         ]
       }
-    ],
-    "global": {
-      "anchors": [
-        {
-          "anchor": "More Info",
-          "href": "https://tryhelium.com",
-          "icon": "lightbulb"
-        }
-      ]
-    }
+    ]
   },
   "logo": {
     "light": "/logo/LargeLogo-cropped.svg",