From f92bf34d9850a6807c4e2116c17cc191a5ca0069 Mon Sep 17 00:00:00 2001
From: Kye Gomez <kye@swarms.world>
Date: Tue, 22 Jul 2025 11:05:43 -0700
Subject: [PATCH] footer links

---
 docs/mkdocs.yml          |  63 ++++++++++++++++++++++++
 docs/overrides/main.html | 100 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 163 insertions(+)

diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml
index 428e5481..aee9f84f 100644
--- a/docs/mkdocs.yml
+++ b/docs/mkdocs.yml
@@ -54,6 +54,69 @@ extra:
     - icon: fontawesome/brands/linkedin
       link: https://www.linkedin.com/company/swarms-corp/
 
+  footer_links:
+    "Getting Started":
+      - title: "Installation"
+        url: "/swarms/install/install/"
+      - title: "Quickstart"
+        url: "/quickstart/"
+      - title: "Environment Setup"
+        url: "/swarms/install/env/"
+      - title: "Basic Agent Example"
+        url: "/swarms/examples/basic_agent/"
+    
+    "Documentation":
+      - title: "Agents"
+        url: "/swarms/agents/index/"
+      - title: "Multi-Agent Architectures"
+        url: "/swarms/structs/index/"
+      - title: "Tools"
+        url: "/swarms/tools/main/"
+      - title: "Models"
+        url: "/swarms/models/agent_and_models/"
+    
+    "Core Capabilities":
+      - title: "Sequential Workflow"
+        url: "/swarms/structs/sequential_workflow/"
+      - title: "Concurrent Workflow"
+        url: "/swarms/structs/concurrentworkflow/"
+      - title: "Hierarchical Swarm"
+        url: "/swarms/structs/hierarchical_swarm/"
+      - title: "Swarm Router"
+        url: "/swarms/structs/swarm_router/"
+    
+    "Examples & Tutorials":
+      - title: "Examples Overview"
+        url: "/examples/index/"
+      - title: "Cookbook"
+        url: "/examples/cookbook_index/"
+      - title: "Templates"
+        url: "/examples/templates/"
+      - title: "Paper Implementations"
+        url: "/examples/paper_implementations/"
+    
+    "API & Cloud":
+      - title: "Swarms Cloud API"
+        url: "/swarms_cloud/swarms_api/"
+      - title: "API Quickstart"
+        url: "/swarms_cloud/quickstart/"
+      - title: "Python Client"
+        url: "/swarms_cloud/python_client/"
+      - title: "Pricing"
+        url: "/swarms_cloud/api_pricing/"
+    
+    "Community":
+      - title: "Contributing"
+        url: "/contributors/main/"
+      - title: "Code Style Guide"
+        url: "/swarms/framework/code_cleanliness/"
+      - title: "Adding Documentation"
+        url: "/contributors/docs/"
+      - title: "Bounty Program"
+        url: "/corporate/bounty_program/"
+      - title: "Support"
+        url: "/swarms/support/"
+
   analytics:
     provider: google
     property: G-MPE9C65596
diff --git a/docs/overrides/main.html b/docs/overrides/main.html
index 43a3a50a..d1663de2 100644
--- a/docs/overrides/main.html
+++ b/docs/overrides/main.html
@@ -6,4 +6,104 @@
   <div style="text-align:center">
     <a href="https://github.com/kyegomez/swarms">Star and contribute</a> to Swarms on GitHub!
   </div>
+{% endblock %}
+
+{% block footer %}
+  <!-- Custom Footer with organized links -->
+  <footer class="md-footer">
+    <div class="md-footer-meta md-typeset">
+      <div class="md-footer__inner md-grid">
+        <!-- Footer Links Section -->
+        <div class="md-footer-links">
+          <div class="md-footer-links__grid">
+            {% for section_name, links in config.extra.footer_links.items() %}
+              <div class="md-footer-links__section">
+                <h4 class="md-footer-links__title">{{ section_name }}</h4>
+                <ul class="md-footer-links__list">
+                  {% for link in links %}
+                    <li class="md-footer-links__item">
+                      <a href="{{ link.url }}" class="md-footer-links__link">
+                        {{ link.title }}
+                      </a>
+                    </li>
+                  {% endfor %}
+                </ul>
+              </div>
+            {% endfor %}
+          </div>
+        </div>
+        
+        <!-- Original Footer Content -->
+        {{ super() }}
+      </div>
+    </div>
+  </footer>
+{% endblock %}
+
+{% block styles %}
+  {{ super() }}
+  <style>
+    .md-footer-links {
+      margin-bottom: 2rem;
+      border-bottom: 1px solid var(--md-default-fg-color--lightest);
+      padding-bottom: 2rem;
+    }
+    
+    .md-footer-links__grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+      gap: 2rem;
+      margin-bottom: 1rem;
+    }
+    
+    .md-footer-links__section {
+      min-width: 0;
+    }
+    
+    .md-footer-links__title {
+      color: var(--md-default-fg-color);
+      font-size: .64rem;
+      font-weight: 700;
+      margin: 0 0 .5rem;
+      text-transform: uppercase;
+      letter-spacing: 0.1em;
+    }
+    
+    .md-footer-links__list {
+      list-style: none;
+      margin: 0;
+      padding: 0;
+    }
+    
+    .md-footer-links__item {
+      margin: 0;
+      padding: 0.2rem 0;
+    }
+    
+    .md-footer-links__link {
+      color: var(--md-default-fg-color--light);
+      text-decoration: none;
+      font-size: .64rem;
+      transition: color 0.2s ease;
+    }
+    
+    .md-footer-links__link:hover {
+      color: var(--md-accent-fg-color);
+      text-decoration: underline;
+    }
+    
+    @media screen and (max-width: 76.1875em) {
+      .md-footer-links__grid {
+        grid-template-columns: repeat(auto-fit, minmax(150px, 1fr));
+        gap: 1.5rem;
+      }
+    }
+    
+    @media screen and (max-width: 44.9375em) {
+      .md-footer-links__grid {
+        grid-template-columns: repeat(2, 1fr);
+        gap: 1rem;
+      }
+    }
+  </style>
 {% endblock %}
\ No newline at end of file