Add Koala integration and document navigation properties

docs.json

@@ -224,6 +224,7 @@
                           "integrations/analytics/heap",
                           "integrations/analytics/hightouch",
                           "integrations/analytics/hotjar",
+                          "integrations/analytics/koala",
                           "integrations/analytics/logrocket",
                           "integrations/analytics/mixpanel",
                           "integrations/analytics/pirsch",

integrations/analytics/koala.mdx

@@ -0,0 +1,27 @@
+---
+title: "Koala"
+description: "Track visitor behavior and identify accounts with Koala to understand who is engaging with your documentation."
+keywords: ["Koala integration", "visitor tracking", "account identification", "public API key"]
+---
+
+Add the following to your `docs.json` file to send analytics to Koala.
+
+<CodeGroup>
+
+```json Analytics options in docs.json
+"integrations": {
+    "koala": {
+        "publicApiKey": "required"
+    }
+}
+```
+
+```json Example
+"integrations": {
+    "koala": {
+        "publicApiKey": "pk_abc123def456"
+    }
+}
+```
+
+</CodeGroup>

integrations/analytics/overview.mdx

@@ -284,6 +284,27 @@
     }
   />
 
+  <Card
+    title="Koala"
+    href="/integrations/analytics/koala"
+    horizontal
+    icon={
+      <svg
+        className="h-6 w-6"
+        width="24"
+        height="24"
+        viewBox="0 0 24 24"
+        fill="none"
+        xmlns="http://www.w3.org/2000/svg"
+      >
+        <circle cx="12" cy="12" r="10" className="fill-black dark:fill-white" />
+        <circle cx="9" cy="10" r="2" className="fill-white dark:fill-black" />
+        <circle cx="15" cy="10" r="2" className="fill-white dark:fill-black" />
+        <ellipse cx="12" cy="15" rx="3" ry="2" className="fill-white dark:fill-black" />
+      </svg>
+    }
+  />
+
   <Card
     title="Hotjar"
     href="/integrations/analytics/hotjar"
@@ -611,10 +632,13 @@
         "hjid": "required",
         "hjsv": "required"
     },
+    "koala": {
+        "publicApiKey": "required"
+    },
     "logrocket": {
         "appId": "required"
     },
     "mixpanel": {
         "projectToken": "required"
     },
     "pirsch": {
@@ -623,7 +647,7 @@
     "plausible": {
         "domain": "required"
     },
     "posthog": {
         "apiKey": "required",
         "apiHost": "optional"
     },

organize/settings-integrations.mdx

@@ -116,6 +116,16 @@ Configure all integrations as properties of the `integrations` object in your `d
   </Expandable>
 </ResponseField>
 
+<ResponseField name="integrations.koala" type="object">
+  Koala visitor tracking and account identification integration.
+
+  <Expandable title="integrations.koala">
+    <ResponseField name="publicApiKey" type="string" required>
+      Your Koala public API key. Minimum length: 2.
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
 <ResponseField name="integrations.logrocket" type="object">
   LogRocket session replay integration.
 

organize/settings-reference.mdx

@@ -146,7 +146,7 @@
 
 Top-level navigation tabs.
 
-**Type:** array of object—each with: `tab` (string, required), `icon` (string), `iconType` (string), `hidden` (boolean), `href` (string uri, required)
+**Type:** array of object—each with: `tab` (string, required), `icon` (string), `iconType` (string), `align` (`"start"` | `"end"`), `hidden` (boolean), `href` (string uri, required)
 
 ##### `navigation.global.anchors`
 
@@ -156,9 +156,9 @@
 
 ##### `navigation.global.dropdowns`
 
 Dropdown menus.
 
-**Type:** array of object—each with: `dropdown` (string, required), `icon` (string), `iconType` (string), `hidden` (boolean), `href` (string uri, required)
+**Type:** array of object—each with: `dropdown` (string, required), `icon` (string), `iconType` (string), `color` (object with `light` and `dark` hex strings), `description` (string), `hidden` (boolean), `href` (string uri, required)
 
 ##### `navigation.global.languages`
 
@@ -178,7 +178,7 @@
 
 Product switcher in the global nav.
 
-**Type:** array of object—each with: `product` (string, required), `description` (string), `icon` (string), `iconType` (string)
+**Type:** array of object—each with: `product` (string, required), `name` (string), `description` (string), `icon` (string), `iconType` (string)
 
 #### `navigation.languages`
 
@@ -208,7 +208,7 @@
 
 #### `navigation.dropdowns`
 
 Dropdown menus.
 
 **Type:** array of object—see `navigation.global.dropdowns` for shape.
 
@@ -905,6 +905,7 @@
 | `integrations.hotjar.hjid` | string | Yes | Hotjar site ID. |
 | `integrations.hotjar.hjsv` | string | Yes | Hotjar script version. |
 | `integrations.intercom.appId` | string (min 6) | Yes | Intercom app ID. |
+| `integrations.koala.publicApiKey` | string (min 2) | Yes | Koala public API key. |
 | `integrations.logrocket.appId` | string | Yes | LogRocket app ID. |
 | `integrations.mixpanel.projectToken` | string | Yes | Mixpanel project token. |
 | `integrations.pirsch.id` | string | Yes | Pirsch site ID. |

organize/settings-structure.mdx

@@ -30,6 +30,9 @@ See [Navigation](/organize/navigation) for complete documentation on building yo
           Display name of the tab. Minimum length: 1.
         </ResponseField>
         <IconsOptional />
+        <ResponseField name="align" type='"start" | "end"'>
+          Tab alignment in the navigation. Set to `end` to push the tab to the right side of the tab bar.
+        </ResponseField>
         <ResponseField name="hidden" type="boolean">
           Whether to hide this tab by default.
         </ResponseField>
@@ -76,6 +79,21 @@ See [Navigation](/organize/navigation) for complete documentation on building yo
           Display name of the dropdown. Minimum length: 1.
         </ResponseField>
         <IconsOptional />
+        <ResponseField name="color" type="object">
+          Custom colors for the dropdown icon.
+
+          <Expandable title="color">
+            <ResponseField name="light" type="string">
+              Dropdown color for light mode. Must be a hex code beginning with `#`.
+            </ResponseField>
+            <ResponseField name="dark" type="string">
+              Dropdown color for dark mode. Must be a hex code beginning with `#`.
+            </ResponseField>
+          </Expandable>
+        </ResponseField>
+        <ResponseField name="description" type="string">
+          Description of the dropdown.
+        </ResponseField>
         <ResponseField name="hidden" type="boolean">
           Whether to hide this dropdown by default.
         </ResponseField>
@@ -130,6 +148,9 @@ See [Navigation](/organize/navigation) for complete documentation on building yo
         <ResponseField name="product" type="string" required>
           Display name of the product.
         </ResponseField>
+        <ResponseField name="name" type="string">
+          Optional display name for the product. When set, this is shown instead of the `product` field value.
+        </ResponseField>
         <ResponseField name="description" type="string">
           Description of the product.
         </ResponseField>