From 310302619b980fdcb8033ac398fea2c8b24eded8 Mon Sep 17 00:00:00 2001 From: harshalmore31 Date: Thu, 24 Jul 2025 23:15:36 +0530 Subject: [PATCH 1/4] updated footer link with button --- docs/mkdocs.yml | 94 +++++++++++++++++++++++------------- docs/overrides/main.html | 100 ++++++++++++++++++++++++++++++++++++++- 2 files changed, 159 insertions(+), 35 deletions(-) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 4027d032..21d5039b 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -55,16 +55,6 @@ extra: link: https://www.linkedin.com/company/swarms-corp/ footer_links: - "Getting Started": - - title: "Installation" - url: "https://docs.swarms.world/en/latest/swarms/install/install/" - - title: "Quickstart" - url: "https://docs.swarms.world/en/latest/quickstart/" - - title: "Environment Setup" - url: "https://docs.swarms.world/en/latest/swarms/install/env/" - - title: "Basic Agent Example" - url: "https://docs.swarms.world/en/latest/swarms/examples/basic_agent/" - "Core Capabilities": - title: "Agents" @@ -82,29 +72,67 @@ extra: - title: "Swarm Router" url: "https://docs.swarms.world/en/latest/swarms/structs/swarm_router/" - - "Templates & Applications": - - title: "Examples Overview" - url: "https://docs.swarms.world/en/latest/examples/index/" - - title: "Cookbook" - url: "https://docs.swarms.world/en/latest/examples/cookbook_index/" - - title: "Templates" - url: "https://docs.swarms.world/en/latest/examples/templates/" - - title: "Paper Implementations" - url: "https://docs.swarms.world/en/latest/examples/paper_implementations/" + "Popular Multi-Agent Patterns": + - title: "Mixture of Agents (MoA)" + url: "https://docs.swarms.world/en/latest/swarms/structs/moa/" + - title: "Sequential Workflow" + url: "https://docs.swarms.world/en/latest/swarms/examples/sequential_example/" + - title: "Concurrent Workflow" + url: "https://docs.swarms.world/en/latest/swarms/examples/concurrent_workflow/" + - title: "Hierarchical Swarm" + url: "https://docs.swarms.world/en/latest/swarms/examples/hierarchical_swarm_example/" + - title: "Group Chat" + url: "https://docs.swarms.world/en/latest/swarms/examples/groupchat_example/" + - title: "Agent Rearrange" + url: "https://docs.swarms.world/en/latest/swarms/structs/agent_rearrange/" + - title: "Deep Research Swarm" + url: "https://docs.swarms.world/en/latest/swarms/structs/deep_research_swarm/" + - title: "MALT Framework" + url: "https://docs.swarms.world/en/latest/swarms/structs/malt/" + + "Popular Tools & Integrations": + - title: "MCP (Model Context Protocol)" + url: "https://docs.swarms.world/en/latest/swarms/examples/agent_with_mcp/" + - title: "OpenAI Tools & Function Calling" + url: "https://docs.swarms.world/en/latest/swarms/examples/agent_structured_outputs/" + - title: "Web Search (Exa, Serper)" + url: "https://docs.swarms.world/en/latest/swarms_tools/search/" + - title: "Browser Automation" + url: "https://docs.swarms.world/en/latest/swarms/examples/swarms_of_browser_agents/" + - title: "Vision & Image Processing" + url: "https://docs.swarms.world/en/latest/swarms/examples/vision_processing/" + - title: "Crypto APIs (CoinGecko, HTX)" + url: "https://docs.swarms.world/en/latest/swarms/examples/agent_with_tools/" + - title: "Yahoo Finance" + url: "https://docs.swarms.world/en/latest/swarms/examples/yahoo_finance/" + - title: "Structured Outputs" + url: "https://docs.swarms.world/en/latest/swarms/agents/structured_outputs/" - - "Contributors": - - title: "Contributing" - url: "https://docs.swarms.world/en/latest/contributors/main/" - - title: "Code Style Guide" - url: "https://docs.swarms.world/en/latest/swarms/framework/code_cleanliness/" - - title: "Adding Documentation" - url: "https://docs.swarms.world/en/latest/contributors/docs/" - - title: "Bounty Program" - url: "https://docs.swarms.world/en/latest/corporate/bounty_program/" - - title: "Support" - url: "https://docs.swarms.world/en/latest/swarms/support/" + "Paper Implementations": + - title: "Paper Implementations Overview" + url: "https://docs.swarms.world/en/latest/examples/paper_implementations/" + - title: "MALT (Multi-Agent Learning Task)" + url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/malt_example.py" + - title: "MAI-DxO (Medical AI Diagnosis)" + url: "https://github.com/The-Swarm-Corporation/Open-MAI-Dx-Orchestrator" + - title: "AI-CoScientist Research Framework" + url: "https://github.com/The-Swarm-Corporation/AI-CoScientist" + - title: "Mixture of Agents (MoA)" + url: "https://github.com/kyegomez/swarms/blob/master/examples/multi_agent/mixture_of_agents_example.py" + - title: "Agent-as-a-Judge Evaluation" + url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/agent_judge_example.py" + - title: "Swarms of Browser Agents" + url: "https://docs.swarms.world/en/latest/examples/swarms_of_browser_agents/" + - title: "Swarms DAO Governance" + url: "https://docs.swarms.world/en/latest/examples/swarms_dao/" + - title: "Deep Research Swarm Examples" + url: "https://github.com/kyegomez/swarms/tree/master/examples/multi_agent/deep_research_examples" + - title: "Hierarchical Swarm Examples" + url: "https://github.com/kyegomez/swarms/tree/master/examples/multi_agent/hiearchical_swarm" + - title: "All Examples Repository" + url: "https://github.com/kyegomez/swarms/tree/master/examples" + - title: "Research Papers Collection" + url: "https://github.com/kyegomez/awesome-multi-agent-papers" "Community": - title: "Twitter" @@ -122,8 +150,6 @@ extra: - title: "Onboarding Session" url: "https://cal.com/swarms/swarms-onboarding-session" - - analytics: provider: google property: G-MPE9C65596 diff --git a/docs/overrides/main.html b/docs/overrides/main.html index c2828415..dd69212e 100644 --- a/docs/overrides/main.html +++ b/docs/overrides/main.html @@ -19,13 +19,22 @@ + {% if links|length > 4 %} + + {% endif %} {% endfor %} @@ -114,6 +123,45 @@ color: var(--md-accent-fg-color); } + /* Hidden footer items */ + .md-footer-links__item--hidden { + display: none; + } + + /* Toggle button styles */ + .md-footer-links__toggle { + background: none; + border: 0.05rem solid; + border-radius: 0.2rem; + cursor: pointer; + display: flex; + align-items: center; + gap: 0.3rem; + font-size: 0.64rem; + font-weight: 500; + margin-top: 0.8rem; + padding: 0.4rem 0.8rem; + text-transform: uppercase; + letter-spacing: 0.05em; + transition: all 150ms ease; + width: auto; + min-width: fit-content; + } + + .md-footer-links__toggle:hover { + transform: translateY(-1px); + } + + .md-footer-links__toggle-icon { + font-size: 0.5rem; + transition: transform 200ms ease; + line-height: 1; + } + + .md-footer-links__toggle--expanded .md-footer-links__toggle-icon { + transform: rotate(180deg); + } + /* Light Mode (Default) */ [data-md-color-scheme="default"] .md-footer-custom { background: #ffffff; @@ -134,6 +182,18 @@ color: #1976d2; } + [data-md-color-scheme="default"] .md-footer-links__toggle { + border-color: #e1e5e9; + color: #636c76; + background: #ffffff; + } + + [data-md-color-scheme="default"] .md-footer-links__toggle:hover { + border-color: #1976d2; + color: #1976d2; + background: #f8f9fa; + } + /* Dark Mode (Slate) */ [data-md-color-scheme="slate"] .md-footer-custom { background: #1F2129; @@ -154,6 +214,18 @@ color: #42a5f5; } + [data-md-color-scheme="slate"] .md-footer-links__toggle { + border-color: #404040; + color: #9ca3af; + background: #1F2129; + } + + [data-md-color-scheme="slate"] .md-footer-links__toggle:hover { + border-color: #42a5f5; + color: #42a5f5; + background: #2a2d38; + } + /* Company Information Section - Base */ .md-footer-company { padding: 1.5rem 0; @@ -292,4 +364,30 @@ } } + + {% endblock %} \ No newline at end of file From 7de6a03640a99863f60a9cebc12a6321e56f6d5d Mon Sep 17 00:00:00 2001 From: harshalmore31 Date: Thu, 24 Jul 2025 23:21:48 +0530 Subject: [PATCH 2/4] updates to the footer layout ! --- docs/overrides/main.html | 65 ++++++++++++++++++++++++++++------------ 1 file changed, 46 insertions(+), 19 deletions(-) diff --git a/docs/overrides/main.html b/docs/overrides/main.html index dd69212e..5acae004 100644 --- a/docs/overrides/main.html +++ b/docs/overrides/main.html @@ -79,8 +79,8 @@ .md-footer-links { display: grid; - grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); - gap: 2rem; + grid-template-columns: repeat(5, 1fr); + gap: 1.2rem; max-width: 1220px; margin: 0 auto; } @@ -90,12 +90,12 @@ } .md-footer-links__title { - font-size: 0.64rem; + font-size: 0.6rem; font-weight: 700; - margin: 0 0 1rem; + margin: 0 0 0.8rem; text-transform: uppercase; letter-spacing: 0.1em; - padding-bottom: 0.4rem; + padding-bottom: 0.3rem; } .md-footer-links__list { @@ -106,14 +106,14 @@ .md-footer-links__item { margin: 0; - line-height: 1.8; + line-height: 1.6; } .md-footer-links__link { text-decoration: none; - font-size: 0.7rem; + font-size: 0.65rem; display: block; - padding: 0.1rem 0; + padding: 0.08rem 0; transition: color 125ms; border-radius: 0.1rem; } @@ -132,15 +132,15 @@ .md-footer-links__toggle { background: none; border: 0.05rem solid; - border-radius: 0.2rem; + border-radius: 0.15rem; cursor: pointer; display: flex; align-items: center; - gap: 0.3rem; - font-size: 0.64rem; + gap: 0.25rem; + font-size: 0.58rem; font-weight: 500; - margin-top: 0.8rem; - padding: 0.4rem 0.8rem; + margin-top: 0.6rem; + padding: 0.3rem 0.6rem; text-transform: uppercase; letter-spacing: 0.05em; transition: all 150ms ease; @@ -153,7 +153,7 @@ } .md-footer-links__toggle-icon { - font-size: 0.5rem; + font-size: 0.45rem; transition: transform 200ms ease; line-height: 1; } @@ -312,28 +312,45 @@ } /* Responsive Design */ - @media screen and (max-width: 76.1875em) { + @media screen and (min-width: 90em) { .md-footer-links { - grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); + max-width: 1400px; gap: 1.5rem; } + } + + @media screen and (max-width: 76.1875em) { + .md-footer-links { + grid-template-columns: repeat(3, 1fr); + gap: 1rem; + } .md-footer-custom { - padding: 2rem 0 1rem; + padding: 1.8rem 0 1rem; } } @media screen and (max-width: 59.9375em) { .md-footer-links { grid-template-columns: repeat(2, 1fr); - gap: 1.5rem; + gap: 1rem; + } + + .md-footer-links__title { + font-size: 0.62rem; + margin: 0 0 0.9rem; + } + + .md-footer-links__link { + font-size: 0.68rem; + padding: 0.1rem 0; } } @media screen and (max-width: 44.9375em) { .md-footer-links { grid-template-columns: 1fr; - gap: 1.5rem; + gap: 1.2rem; } .md-footer-custom { @@ -344,6 +361,16 @@ padding: 0 1rem; } + .md-footer-links__title { + font-size: 0.65rem; + margin: 0 0 1rem; + } + + .md-footer-links__link { + font-size: 0.7rem; + padding: 0.12rem 0; + } + /* Company section mobile styles */ .md-footer-company__content { flex-direction: column; From dfcd608525ee23699466dea9c0fb76a1005ba9c4 Mon Sep 17 00:00:00 2001 From: harshalmore31 Date: Fri, 25 Jul 2025 10:29:14 +0530 Subject: [PATCH 3/4] fixed the links --- docs/mkdocs.yml | 25 +------------------------ 1 file changed, 1 insertion(+), 24 deletions(-) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index 94d57d8d..df7314db 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -63,12 +63,6 @@ extra: url: "https://docs.swarms.world/en/latest/swarms/tools/tools_examples/" - title: "Multi-Agent Architectures" url: "https://docs.swarms.world/en/latest/swarms/concept/swarm_architectures/" - - title: "Sequential Workflow" - url: "https://docs.swarms.world/en/latest/swarms/structs/sequential_workflow/" - - title: "Concurrent Workflow" - url: "https://docs.swarms.world/en/latest/swarms/structs/concurrentworkflow/" - - title: "Hierarchical Swarm" - url: "https://docs.swarms.world/en/latest/swarms/structs/hierarchical_swarm/" - title: "Swarm Router" url: "https://docs.swarms.world/en/latest/swarms/structs/swarm_router/" @@ -85,10 +79,7 @@ extra: url: "https://docs.swarms.world/en/latest/swarms/examples/groupchat_example/" - title: "Agent Rearrange" url: "https://docs.swarms.world/en/latest/swarms/structs/agent_rearrange/" - - title: "Deep Research Swarm" - url: "https://docs.swarms.world/en/latest/swarms/structs/deep_research_swarm/" - - title: "MALT Framework" - url: "https://docs.swarms.world/en/latest/swarms/structs/malt/" + "Popular Tools & Integrations": - title: "MCP (Model Context Protocol)" @@ -109,28 +100,14 @@ extra: url: "https://docs.swarms.world/en/latest/swarms/agents/structured_outputs/" "Paper Implementations": - - title: "Paper Implementations Overview" - url: "https://docs.swarms.world/en/latest/examples/paper_implementations/" - title: "MALT (Multi-Agent Learning Task)" url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/malt_example.py" - title: "MAI-DxO (Medical AI Diagnosis)" url: "https://github.com/The-Swarm-Corporation/Open-MAI-Dx-Orchestrator" - title: "AI-CoScientist Research Framework" url: "https://github.com/The-Swarm-Corporation/AI-CoScientist" - - title: "Mixture of Agents (MoA)" - url: "https://github.com/kyegomez/swarms/blob/master/examples/multi_agent/mixture_of_agents_example.py" - title: "Agent-as-a-Judge Evaluation" url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/agent_judge_example.py" - - title: "Swarms of Browser Agents" - url: "https://docs.swarms.world/en/latest/examples/swarms_of_browser_agents/" - - title: "Swarms DAO Governance" - url: "https://docs.swarms.world/en/latest/examples/swarms_dao/" - - title: "Deep Research Swarm Examples" - url: "https://github.com/kyegomez/swarms/tree/master/examples/multi_agent/deep_research_examples" - - title: "Hierarchical Swarm Examples" - url: "https://github.com/kyegomez/swarms/tree/master/examples/multi_agent/hiearchical_swarm" - - title: "All Examples Repository" - url: "https://github.com/kyegomez/swarms/tree/master/examples" - title: "Research Papers Collection" url: "https://github.com/kyegomez/awesome-multi-agent-papers" From a5e39f289f6d298274a56d3d9da11e85bae7a4ce Mon Sep 17 00:00:00 2001 From: harshalmore31 Date: Fri, 25 Jul 2025 18:54:37 +0530 Subject: [PATCH 4/4] updates !! --- docs/mkdocs.yml | 94 +++++++++++++++++++++++-------------------------- 1 file changed, 45 insertions(+), 49 deletions(-) diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index df7314db..2ac7a052 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -56,76 +56,72 @@ extra: footer_links: + "Quick Start": + - title: "Installation" + url: "https://docs.swarms.world/en/latest/swarms/install/install/" + - title: "Quickstart Guide" + url: "https://docs.swarms.world/en/latest/quickstart/" + - title: "Environment Setup" + url: "https://docs.swarms.world/en/latest/swarms/install/env/" + - title: "Basic Agent Example" + url: "https://docs.swarms.world/en/latest/swarms/examples/basic_agent/" + "Core Capabilities": - title: "Agents" url: "https://docs.swarms.world/en/latest/swarms/structs/agent/" - - title: "Tools and MCP" - url: "https://docs.swarms.world/en/latest/swarms/tools/tools_examples/" - title: "Multi-Agent Architectures" url: "https://docs.swarms.world/en/latest/swarms/concept/swarm_architectures/" + - title: "LLM Providers" + url: "https://docs.swarms.world/en/latest/swarms/examples/model_providers/" - title: "Swarm Router" url: "https://docs.swarms.world/en/latest/swarms/structs/swarm_router/" - "Popular Multi-Agent Patterns": - - title: "Mixture of Agents (MoA)" - url: "https://docs.swarms.world/en/latest/swarms/structs/moa/" - - title: "Sequential Workflow" - url: "https://docs.swarms.world/en/latest/swarms/examples/sequential_example/" - - title: "Concurrent Workflow" - url: "https://docs.swarms.world/en/latest/swarms/examples/concurrent_workflow/" - - title: "Hierarchical Swarm" - url: "https://docs.swarms.world/en/latest/swarms/examples/hierarchical_swarm_example/" - - title: "Group Chat" - url: "https://docs.swarms.world/en/latest/swarms/examples/groupchat_example/" - - title: "Agent Rearrange" - url: "https://docs.swarms.world/en/latest/swarms/structs/agent_rearrange/" - - - "Popular Tools & Integrations": + "Advanced Concepts": + - title: "MALT (Multi-Agent Learning Task)" + url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/malt_example.py" + - title: "MAI-DxO (Medical AI Diagnosis)" + url: "https://github.com/The-Swarm-Corporation/Open-MAI-Dx-Orchestrator" + - title: "AI-CoScientist Research Framework" + url: "https://github.com/The-Swarm-Corporation/AI-CoScientist" + - title: "Agent-as-a-Judge Evaluation" + url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/agent_judge_example.py" + - title: "Research Papers Collection" + url: "https://github.com/kyegomez/awesome-multi-agent-papers" + + + "Popular Tools Integration": + - title: "Tools and MCP" + url: "https://docs.swarms.world/en/latest/swarms/tools/tools_examples/" - title: "MCP (Model Context Protocol)" url: "https://docs.swarms.world/en/latest/swarms/examples/agent_with_mcp/" - title: "OpenAI Tools & Function Calling" url: "https://docs.swarms.world/en/latest/swarms/examples/agent_structured_outputs/" - title: "Web Search (Exa, Serper)" url: "https://docs.swarms.world/en/latest/swarms_tools/search/" - - title: "Browser Automation" - url: "https://docs.swarms.world/en/latest/swarms/examples/swarms_of_browser_agents/" - title: "Vision & Image Processing" url: "https://docs.swarms.world/en/latest/swarms/examples/vision_processing/" + - title: "Browser Automation" + url: "https://docs.swarms.world/en/latest/swarms/examples/swarms_of_browser_agents/" - title: "Crypto APIs (CoinGecko, HTX)" url: "https://docs.swarms.world/en/latest/swarms/examples/agent_with_tools/" - title: "Yahoo Finance" url: "https://docs.swarms.world/en/latest/swarms/examples/yahoo_finance/" - - title: "Structured Outputs" - url: "https://docs.swarms.world/en/latest/swarms/agents/structured_outputs/" - - "Paper Implementations": - - title: "MALT (Multi-Agent Learning Task)" - url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/malt_example.py" - - title: "MAI-DxO (Medical AI Diagnosis)" - url: "https://github.com/The-Swarm-Corporation/Open-MAI-Dx-Orchestrator" - - title: "AI-CoScientist Research Framework" - url: "https://github.com/The-Swarm-Corporation/AI-CoScientist" - - title: "Agent-as-a-Judge Evaluation" - url: "https://github.com/kyegomez/swarms/blob/master/examples/single_agent/reasoning_agent_examples/agent_judge_example.py" - - title: "Research Papers Collection" - url: "https://github.com/kyegomez/awesome-multi-agent-papers" - "Community": - - title: "Twitter" - url: "https://twitter.com/swarms_corp" - - title: "Discord" - url: "https://discord.gg/jM3Z6M9uMq" - - title: "YouTube" - url: "https://www.youtube.com/channel/UC9yXyitkbU_WSy7bd_41SqQ" - - title: "LinkedIn" - url: "https://www.linkedin.com/company/the-swarm-corporation" - - title: "Blog" - url: "https://medium.com/@kyeg" - - title: "Events" - url: "https://lu.ma/5p2jnc2v" - - title: "Onboarding Session" - url: "https://cal.com/swarms/swarms-onboarding-session" + "Applications Use Case": + - title: "Examples Overview" + url: "https://docs.swarms.world/en/latest/examples/index/" + - title: "Templates & Applications" + url: "https://docs.swarms.world/en/latest/examples/templates/" + - title: "Financial Analysis Swarms" + url: "https://docs.swarms.world/en/latest/swarms/examples/swarms_api_finance/" + - title: "Deep Research Swarm" + url: "https://docs.swarms.world/en/latest/swarms/structs/deep_research_swarm/" + - title: "Medical Diagnosis Systems" + url: "https://docs.swarms.world/en/latest/swarms/examples/swarms_api_medical/" + - title: "DAO Governance" + url: "https://docs.swarms.world/en/latest/swarms/examples/swarms_dao/" + - title: "All Examples Repository" + url: "https://github.com/kyegomez/swarms/tree/master/examples" analytics: provider: google