From 6e31c7da4448aec35954ead6e57347ce403e57d5 Mon Sep 17 00:00:00 2001
From: Caio Pizzol <97641911+caio-pizzol@users.noreply.github.com>
Date: Wed, 29 Jul 2026 11:02:34 -0300
Subject: [PATCH] docs(docs): add a version switcher to the V1 site (#988)

A reader landing on the V1 docs from an old link had one route to V2: a banner
they can dismiss, after which nothing on the page says which version they are
reading. Mintlify's own version switcher sits next to the logo and stays there.

Marking V1 as the default is what makes the control read v1 on this site rather
than v2.

With the switcher carrying the version, the banner no longer has to state it.
It keeps the news and the link and drops the middle clause.

Ported-From-Source-Repo: superdoc/orbit
Ported-From-Source-Commit: f53bbccf4dc1cc61176c4ec3f4daead7a60b4ebc
Ported-Public-Prefix: superdoc/public
---
 apps/docs/docs.json | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/apps/docs/docs.json b/apps/docs/docs.json
index f556b8beb8..322103d218 100644
--- a/apps/docs/docs.json
+++ b/apps/docs/docs.json
@@ -43,6 +43,12 @@
     ]
   },
   "navigation": {
+    "global": {
+      "versions": [
+        { "version": "v2", "href": "https://docs.superdoc.dev" },
+        { "version": "v1", "default": true, "href": "https://docs-v1.superdoc.dev" }
+      ]
+    },
     "tabs": [
       {
         "tab": "SuperDoc",
@@ -301,7 +307,7 @@
     ]
   },
   "banner": {
-    "content": "**SuperDoc 2 is available.** You're viewing the SuperDoc 1 documentation. [Open the SuperDoc 2 docs \u2192](https://docs.superdoc.dev/)",
+    "content": "**SuperDoc v2 is available.** [Read the v2 docs](https://docs.superdoc.dev/)",
     "dismissible": true
   },
   "redirects": [