From dc01a0abff9a1cadfbb7dc8b6ef41ca19bfc83cf Mon Sep 17 00:00:00 2001
From: Federico Coppede <fcoppede@gmail.com>
Date: Wed, 14 Jan 2026 08:56:01 -0300
Subject: [PATCH] docs: fixed broken references docs homepage (#11357)

Fixed broken references in the Zitadel docs homepage
---
 docs/sidebars.js        | 55 ++++++++++++++++++++++++++++++++++++++---
 docs/src/pages/index.js |  8 +++---
 2 files changed, 56 insertions(+), 7 deletions(-)

diff --git a/docs/sidebars.js b/docs/sidebars.js
index 9b30f3c0a..fbec819d9 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -67,10 +67,24 @@ module.exports = {
         {
           type: "category",
           label: "Example Applications",
+          link: {
+            type: "generated-index",
+            title: "Example Applications",
+            slug: "/examples/introduction",
+            description:
+              "Practical examples showing how to integrate ZITADEL authentication and secure APIs across different application types and frameworks.",
+          },
           items: [
             {
               type: "category",
               label: "Frontend (SPA)",
+              link: {
+                type: "generated-index",
+                title: "Frontend (SPA) Quickstart Guides",
+                slug: "/examples/introduction/frontend",
+                description:
+                  "Quickstart guides for integrating ZITADEL authentication into frontend single-page applications.",
+              },
               items: [
                 {
                   type: "link",
@@ -85,6 +99,13 @@ module.exports = {
             {
               type: "category",
               label: "Mobile & Native",
+              link: {
+                type: "generated-index",
+                title: "Mobile & Native Quickstart Guides",
+                slug: "/examples/introduction/mobile",
+                description:
+                  "Quickstart guides for integrating ZITADEL authentication into Mobile & Native applications.",
+              },
               items: [
                 "examples/login/flutter",
               ],
@@ -92,6 +113,13 @@ module.exports = {
             {
               type: "category",
               label: "Full-Stack / SSR",
+              link: {
+                type: "generated-index",
+                title: "Full-Stack / SSR Quickstart Guides",
+                slug: "/examples/introduction/fullstack",
+                description:
+                  "Quickstart guides for integrating ZITADEL authentication into Full-Stack / SSR applications.",
+              },
               items: [
                 "examples/login/nextjs",
                 "examples/login/nextjs-b2b",
@@ -100,6 +128,13 @@ module.exports = {
             {
               type: "category",
               label: "Web App (Server-Side)",
+              link: {
+                type: "generated-index",
+                title: "Web App (Server-Side) Quickstart Guides",
+                slug: "/examples/introduction/webapp",
+                description:
+                  "Quickstart guides for integrating ZITADEL authentication into Web App (Server-Side) applications.",
+              },
               items: [
                 "examples/login/symfony",
                 "examples/login/java-spring",
@@ -110,6 +145,13 @@ module.exports = {
             {
               type: "category",
               label: "APIs / Backend Services",
+              link: {
+                type: "generated-index",
+                title: "APIs / Backend Quickstart Guides",
+                slug: "/examples/introduction/backend",
+                description:
+                  "Quickstart guides for integrating ZITADEL authentication into APIs / Backend Services.",
+              },
               items: [
                 "examples/secure-api/go",
                 "examples/secure-api/java-spring",
@@ -184,6 +226,13 @@ module.exports = {
     {
       type: "category",
       label: "Integrate & Authenticate",
+      link: {
+        type: "generated-index",
+        title: "Integrate",
+        slug: "guides/integrate",
+        description:
+          "Integrate your users and application with ZITADEL. In this section you will find resource on how to authenticate your users, configure external identity providers, access the ZITADEL APIs to manage resources, and integrate with third party services and tools.",
+      },
       collapsed: true,
       items: [
         {
@@ -313,7 +362,7 @@ module.exports = {
                     "sdk-examples/client-libraries/python",
                     "sdk-examples/flask",
                     "sdk-examples/django",
-					"sdk-examples/fastapi",
+                    "sdk-examples/fastapi",
                   ],
                 },
                 {
@@ -326,7 +375,7 @@ module.exports = {
                   label: "Java",
                   items: [
                     "sdk-examples/java",
-					"sdk-examples/spring",
+                    "sdk-examples/spring",
                     "sdk-examples/client-libraries/java",
                   ],
                 },
@@ -335,7 +384,7 @@ module.exports = {
                   label: "PHP",
                   items: [
                     "sdk-examples/symfony",
-					"sdk-examples/laravel",
+                    "sdk-examples/laravel",
                     "sdk-examples/client-libraries/php",
                   ],
                 },
diff --git a/docs/src/pages/index.js b/docs/src/pages/index.js
index 8c499f674..b1a6c284c 100644
--- a/docs/src/pages/index.js
+++ b/docs/src/pages/index.js
@@ -43,7 +43,7 @@ const features = [
               description=""
             />
             <ListElement
-              link="/docs/sdk-examples/introduction"
+              link="/docs/examples/introduction"
               type={ICONTYPE.APIS}
               title="Example Apps"
               description=""
@@ -89,7 +89,7 @@ const features = [
               description=""
             />
             <ListElement
-              link="/docs/support/troubleshooting"
+              link="/docs/guides/manage/cloud/support"
               type={ICONTYPE.HELP}
               title="Support"
               description=""
@@ -120,13 +120,13 @@ const features = [
             description="The ultimate guide to get started with ZITADEL."
           />
           <ListElement
-            link="/docs/examples/login/angular"
+            link="/docs/examples/introduction/frontend"
             type={ICONTYPE.APIS}
             title="Frontend Quickstart Guides"
             description=""
           />
           <ListElement
-            link="/docs/examples/secure-api/go"
+            link="/docs/examples/introduction/backend"
             type={ICONTYPE.APIS}
             title="Backend Quickstart Guides"
             description=""