diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index e48e92a7..b035b219 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -55,74 +55,73 @@ extra: link: https://www.linkedin.com/company/swarms-corp/ footer_links: - "Getting Started": + + "Quick Start": - title: "Installation" url: "https://docs.swarms.world/en/latest/swarms/install/install/" - - title: "Quickstart" + - 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: "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: "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/" - - "Templates & Applications": + "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: "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/" + + "Applications Use Case": - 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" + - title: "Templates & Applications" url: "https://docs.swarms.world/en/latest/examples/templates/" - - title: "Paper Implementations" - url: "https://docs.swarms.world/en/latest/examples/paper_implementations/" - - - "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/" - - "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" - - + - 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 diff --git a/docs/overrides/main.html b/docs/overrides/main.html index c2828415..5acae004 100644 --- a/docs/overrides/main.html +++ b/docs/overrides/main.html @@ -19,13 +19,22 @@ + {% if links|length > 4 %} + + {% endif %} {% endfor %} @@ -70,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; } @@ -81,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 { @@ -97,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; } @@ -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.15rem; + cursor: pointer; + display: flex; + align-items: center; + gap: 0.25rem; + font-size: 0.58rem; + font-weight: 500; + margin-top: 0.6rem; + padding: 0.3rem 0.6rem; + 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.45rem; + 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; @@ -240,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 { @@ -272,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; @@ -292,4 +391,30 @@ } } + + {% endblock %} \ No newline at end of file