From 727fdd866b50c9351cb48f34ef33bbcc07e80640 Mon Sep 17 00:00:00 2001
From: "Ketan (CometChat)" <ketan.yekale@cometchat.com>
Date: Fri, 7 Aug 2026 15:08:28 +0530
Subject: [PATCH] docs: add site banner + all-versions page while version
 selector is broken
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The desktop version-selector dropdown crashes with Mintlify's client-side
insertBefore error (Error 500 page) — platform bug reported to Mintlify.
Customers cannot switch versions in the UI, but every versioned page URL
serves fine.

Mitigation until Mintlify ships a fix:
- dismissible site-wide warning banner linking to /versions
- versions.mdx: direct links to every version of every UI Kit / SDK
  (hidden page, not in navigation), generated from docs.json

Revert this commit once the selector works again.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 docs.json    |  5 +++++
 versions.mdx | 46 ++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)
 create mode 100644 versions.mdx

diff --git a/docs.json b/docs.json
index cb43da08b..080d28f3c 100644
--- a/docs.json
+++ b/docs.json
@@ -3,6 +3,11 @@
   "theme": "aspen",
   "name": "CometChat Docs",
   "description": "Technical documentation & Implementation guides to add In-app Messaging & Voice & Video Calling to your apps and websites in minutes.",
+  "banner": {
+    "content": "The version selector is temporarily unavailable. [Open any version directly →](/versions)",
+    "type": "warning",
+    "dismissible": true
+  },
   "colors": {
     "primary": "#6851D6",
     "light": "#6851D6",
diff --git a/versions.mdx b/versions.mdx
new file mode 100644
index 000000000..7d6610ab6
--- /dev/null
+++ b/versions.mdx
@@ -0,0 +1,46 @@
+---
+title: "All documentation versions"
+description: "Direct links to every version of the CometChat UI Kits and SDKs while the version selector is being fixed."
+---
+
+The in-page version selector is temporarily unavailable. Use the direct links below to open any version of the documentation.
+
+## Chat & Messaging — UI Kits
+
+**React:** [v7](/ui-kit/react/overview) · [v6](/ui-kit/react/v6/overview) · [v5](/ui-kit/react/v5/overview) · [v4](/ui-kit/react/v4/overview) · [v3](/ui-kit/react/v3/overview) · [v2](/ui-kit/react/v2/overview)
+
+**React Native:** [v5](/ui-kit/react-native/overview) · [v4](/ui-kit/react-native/v4/overview) · [v3](/ui-kit/react-native/v3/overview) · [v2](/ui-kit/react-native/v2/overview)
+
+**iOS:** [v5](/ui-kit/ios/overview) · [v4](/ui-kit/ios/v4/overview) · [v3](/ui-kit/ios/v3/overview) · [v2](/ui-kit/ios/v2/overview)
+
+**Android:** [v6](/ui-kit/android/overview) · [v5](/ui-kit/android/v5/overview) · [v4](/ui-kit/android/v4/overview) · [v3](/ui-kit/android/v3/overview) · [v2](/ui-kit/android/v2/overview)
+
+**Flutter:** [v6](/ui-kit/flutter/overview) · [v5](/ui-kit/flutter/v5/overview) · [v4](/ui-kit/flutter/v4/overview)
+
+**Angular:** [v5](/ui-kit/angular/overview) · [v4](/ui-kit/angular/v4/overview) · [v3](/ui-kit/angular/3.0/overview) · [v2](/ui-kit/angular/2.0/overview)
+
+**Vue:** [v4](/ui-kit/vue/overview) · [v3](/ui-kit/vue/3.0/overview) · [v2](/ui-kit/vue/2.0/overview)
+
+## Chat & Messaging — SDKs
+
+**JavaScript:** [v4](/sdk/javascript/overview) · [v3](/sdk/javascript/3.0/overview) · [v2](/sdk/javascript/2.0/overview)
+
+**React Native:** [v4](/sdk/react-native/overview) · [v3](/sdk/react-native/3.0/overview) · [v2](/sdk/react-native/2.0/overview)
+
+**iOS:** [v4](/sdk/ios/overview) · [v3](/sdk/ios/3.0/overview) · [v2](/sdk/ios/2.0/overview)
+
+**Android:** [v5](/sdk/android/v5/overview) · [v4](/sdk/android/overview) · [v3](/sdk/android/3.0/overview) · [v2](/sdk/android/2.0/overview)
+
+**Flutter:** [v5](/sdk/flutter/overview) · [v4](/sdk/flutter/v4/overview) · [v3](/sdk/flutter/3.0/overview)
+
+## Voice & Video Calling — SDK
+
+**JavaScript:** [v5](/calls/javascript/overview) · [v4](/calls/v4/javascript/overview)
+
+**React Native:** [v5](/calls/react-native/overview) · [v4](/calls/v4/react-native/overview)
+
+**iOS:** [v5](/calls/ios/overview) · [v4](/calls/v4/ios/overview)
+
+**Android:** [v5](/calls/android/overview) · [v4](/calls/v4/android/overview)
+
+**Flutter:** [v5](/calls/flutter/overview) · [v4](/calls/v4/flutter/overview)