New sidebar mockup

app/en/_meta.tsx

@@ -6,16 +6,19 @@ const meta: MetaRecord = {
       copyPage: false,
     },
   },
+  // 1.0 Home Section
   home: {
     type: "page",
-    title: "Home",
-    href: "/get-started",
+    title: "Docs",
+    href: "/home",
   },
+  // MCP Servers Section
   "mcp-servers": {
     type: "page",
-    title: "MCP Servers",
+    title: "Integrations",
     href: "/mcp-servers",
   },
+  // API & SDKs Section
   references: {
     type: "page",
     title: "API & SDKs",

app/en/home/_meta.tsx

@@ -1,4 +1,4 @@
-import { BadgeHelp, Globe, HeartPulse, Home, Shield } from "lucide-react";
+import { Home } from "lucide-react";
 import type { MetaRecord } from "nextra";
 
 function TitleWithIcon({
@@ -17,11 +17,6 @@ function TitleWithIcon({
 }
 
 export const meta: MetaRecord = {
-  "*": {
-    theme: {
-      copyPage: true,
-    },
-  },
   index: {
     title: <TitleWithIcon icon={Home}>Home</TitleWithIcon>,
     theme: {
@@ -31,129 +26,98 @@ export const meta: MetaRecord = {
       copyPage: false,
     },
   },
-  arcade: {
-    title: <TitleWithIcon icon={Globe}>Arcade.dev</TitleWithIcon>,
-    href: "https://arcade.dev",
-  },
-  "-- Getting Started": {
+  "-- Get Started": {
     type: "separator",
-    title: "Using Arcade",
-  },
-  quickstart: {
-    title: "Hosted Tools Quickstart",
-  },
-  "custom-mcp-server-quickstart": {
-    title: "Build MCP Server QuickStart",
-  },
-  "api-keys": {
-    title: "Get an API key",
-  },
-  "-- Authoring Tools": {
+    title: "Get Started",
+  },
+  "about-arcade": "About Arcade",
+  setup: "Setup",
+  quickstarts: "Quickstarts",
+  "common-use-cases": "Common use cases",
+  "example-agents": "Example agents",
+  tools: "Tools",
+  glossary: "Glossary",
+  faq: "FAQ",
+  changelog: "Changelog",
+  "-- Guides": {
     type: "separator",
-    title: "Authoring Tools",
-  },
-  "build-tools": {
-    title: "Build tools",
-  },
-  "evaluate-tools": {
-    title: "Evaluate tools",
-  },
-  "serve-tools": {
-    title: "Serve tools",
+    title: "Guides",
   },
-  "-- Agent Frameworks and MCP": {
+  "configure-arcade-section": "Configure Arcade",
+  "calling-tools": "Call tools",
+  "creating-tools": "Create tools",
+  "agent-frameworks": "Agent frameworks",
+  "sharing-with-end-users": "User-facing agents",
+  observability: "Observability",
+  "deployment-hosting": "Deployment and hosting",
+  "security-section": "Security and compliance",
+  "-- Learn": {
     type: "separator",
-    title: "Agent Frameworks and MCP",
-  },
-  "mcp-clients": {
-    title: "MCP Clients",
-  },
-  langchain: {
-    title: "LangChain",
-  },
-  crewai: {
-    title: "CrewAI",
-  },
-  "google-adk": {
-    title: "Google ADK",
-  },
-  mastra: {
-    title: "Mastra",
+    title: "Learn",
   },
-  "oai-agents": {
-    title: "OpenAI Agents",
-  },
-  vercelai: {
-    title: "Vercel AI",
-  },
-  "-- Core Concepts": {
+  "what-is-agent": "What's an agent",
+  "auth-and-secrets": "How do auth and secrets work",
+  "agentic-architecture": "Agentic architectures & workflows",
+  "-- Reference": {
     type: "separator",
-    title: "Core Concepts",
-  },
-  "use-tools": {
-    title: "Tool Calling",
-  },
-  auth: {
-    title: "Authorization",
-  },
-  "mcp-gateways": {
-    title: "MCP Gateways",
-  },
-  "arcade-cli": {
-    title: "Arcade CLI",
+    title: "Reference",
+  },
+  api: "API",
+  "arcade-mcp": "Arcade MCP (MCP server SDK)",
+  "arcade-clients": "Arcade clients",
+  "arcade-cli": "Arcade CLI",
+  "auth-providers": "Auth Providers",
+  // Hide auto-discovered directories
+  "api-keys": {
+    display: "hidden",
   },
-  "-- Hosting options": {
-    type: "separator",
-    title: "Hosting options",
+  "contact-us": {
+    display: "hidden",
   },
   "hosting-overview": {
-    title: "Overview",
-  },
-  deployment: {
-    title: "Deployment",
+    display: "hidden",
   },
-  "auth-providers": {
-    title: "Customizing Auth",
+  "mcp-clients": {
+    display: "hidden",
   },
-  "-- Guides": {
-    type: "separator",
-    title: "Guides",
+  "mcp-gateway-quickstart": {
+    display: "hidden",
   },
-  glossary: {
-    title: "Glossary",
+  "python-quickstart": {
+    display: "hidden",
   },
-  faq: {
-    title: "FAQ",
+  "registry-early-access": {
+    display: "hidden",
   },
-  "compare-server-types": {
-    title: "Compare Server Types",
+  "sample-agents": {
+    display: "hidden",
   },
-  "agentic-development": {
-    title: "Agentic Development",
+  "tool-calling-intro": {
+    display: "hidden",
   },
-  changelog: {
-    title: "Changelog",
+  guides: {
+    display: "hidden",
   },
-  "-- Registry": {
-    type: "separator",
-    title: "Registry",
+  "add-external-mcp": {
+    display: "hidden",
   },
-  "registry-early-access": {
-    title: "Registry Early Access",
+  "build-custom-mcp": {
+    display: "hidden",
   },
-  "-- Resources": {
-    type: "separator",
-    title: "Resources",
+  concepts: {
+    display: "hidden",
   },
-  "contact-us": {
-    title: <TitleWithIcon icon={BadgeHelp}>Contact us</TitleWithIcon>,
+  examples: {
+    display: "hidden",
   },
   security: {
-    title: <TitleWithIcon icon={Shield}>Security</TitleWithIcon>,
+    display: "hidden",
+  },
+  "turn-api-to-mcp": {
+    display: "hidden",
   },
-  status: {
-    title: <TitleWithIcon icon={HeartPulse}>Status</TitleWithIcon>,
-    href: "https://status.arcade.dev/",
+  "why-agents-call-tools": {
+    display: "hidden",
   },
 };
 

app/en/home/auth/how-arcade-helps/page.mdx → app/en/home/about-arcade/page.mdx

@@ -75,4 +75,4 @@ console.log(response.output.value);
 ````
 
 </Tabs.Tab>
-</Tabs>
+</Tabs>

app/en/home/add-external-mcp/page.mdx

@@ -0,0 +1,3 @@
+# Add external MCP Servers to Arcade
+
+Learn how to integrate external MCP servers with Arcade.

app/en/home/agent-frameworks/_meta.tsx

@@ -0,0 +1,10 @@
+export default {
+  vanilla: "Vanilla",
+  langchain: "LangGraph",
+  "oai-agents": "OpenAI agents",
+  crewai: "CrewAI",
+  "open-agents": "OpenAgents",
+  "google-adk": "Google ADK",
+  mastra: "Mastra",
+  vercelai: "Vercel AI",
+};

app/en/home/crewai/_meta.tsx → app/en/home/agent-frameworks/crewai/_meta.tsx

@@ -8,8 +8,11 @@ const meta: MetaRecord = {
       copyPage: true,
     },
   },
-  "use-arcade-tools": {
-    title: "Using Arcade tools",
+  "set-up-python": {
+    title: "Set up with Python",
+  },
+  "set-up-typescript": {
+    title: "Set up with TypeScript",
   },
   "custom-auth-flow": {
     title: "Custom auth flow",

app/en/home/agent-frameworks/crewai/set-up-python/page.mdx

@@ -0,0 +1,7 @@
+# Set up Arcade with CrewAI (Python)
+
+Documentation coming soon.
+
+## Overview
+
+This section will contain detailed information about using CrewAI with Python.

app/en/home/agent-frameworks/crewai/set-up-typescript/page.mdx

@@ -0,0 +1,7 @@
+# Set up Arcade with CrewAI (TypeScript)
+
+Documentation coming soon.
+
+## Overview
+
+This section will contain detailed information about using CrewAI with TypeScript.

app/en/home/agent-frameworks/google-adk/_meta.tsx

@@ -0,0 +1,4 @@
+export default {
+  "set-up-python": "Set up with Python",
+  "set-up-typescript": "Set up with TypeScript",
+};

app/en/home/google-adk/use-arcade-tools/page.mdx → app/en/home/agent-frameworks/google-adk/set-up-python/page.mdx

@@ -219,4 +219,4 @@ Now that you have integrated Arcade tools into your Google ADK application, you
 - Try out multi-agent systems using different Arcade tools
 - Build your own custom tools with the Arcade Tool SDK
 
-Enjoy exploring Arcade and building powerful AI-enabled Python applications!
+Enjoy exploring Arcade and building powerful AI-enabled Python applications!

app/en/home/agent-frameworks/google-adk/set-up-typescript/page.mdx

@@ -0,0 +1,7 @@
+# Set up Arcade with Google ADK (TypeScript)
+
+Documentation coming soon.
+
+## Overview
+
+This section will contain detailed information about using Google ADK with TypeScript.

app/en/home/agent-frameworks/langchain/_meta.tsx

@@ -0,0 +1,5 @@
+export default {
+  "set-up-python": "Set up with Python",
+  "set-up-typescript": "Set up with TypeScript",
+  "using-langgraph-tools": "Using LangGraph tools",
+};

app/en/home/agent-frameworks/langchain/set-up-python/page.mdx

@@ -0,0 +1,8 @@
+---
+title: "Set up Arcade with LangChain (Python)"
+description: "Get started with LangChain using Python"
+---
+
+# Set up Arcade with LangChain (Python)
+
+Coming soon!

app/en/home/agent-frameworks/langchain/set-up-typescript/page.mdx

@@ -0,0 +1,8 @@
+---
+title: "Set up Arcade with LangChain (TypeScript)"
+description: "Get started with LangChain using TypeScript"
+---
+
+# Set up Arcade with LangChain (TypeScript)
+
+Coming soon!

app/en/home/langchain/auth-langchain-tools/page.mdx → app/en/home/agent-frameworks/langchain/using-langgraph-tools/page.mdx

@@ -219,4 +219,4 @@ for await (const event of events) {
 
 ### Next Steps
 
-Now you're ready to explore more LangChain tools with Arcade. Try integrating additional MCP Servers and crafting more complex queries to enhance your AI workflows.
+Now you're ready to explore more LangChain tools with Arcade. Try integrating additional MCP Servers and crafting more complex queries to enhance your AI workflows.

app/en/home/mastra/_meta.tsx → app/en/home/agent-frameworks/mastra/_meta.tsx

@@ -8,14 +8,8 @@ const meta: MetaRecord = {
       copyPage: true,
     },
   },
-  overview: {
-    title: "Overview",
-  },
-  "use-arcade-tools": {
-    title: "Using Arcade tools",
-  },
-  "user-auth-interrupts": {
-    title: "Managing user authorization",
+  "set-up-typescript": {
+    title: "Set up with TypeScript",
   },
 };
 

app/en/home/agent-frameworks/mastra/set-up-typescript/page.mdx

@@ -0,0 +1,7 @@
+# Set up Arcade with Mastra (TypeScript)
+
+Documentation coming soon.
+
+## Overview
+
+This section will contain detailed information about using Mastra with TypeScript.

app/en/home/agent-frameworks/oai-agents/_meta.tsx

@@ -0,0 +1,4 @@
+export default {
+  "set-up-python": "Set up with Python",
+  "set-up-typescript": "Set up with TypeScript",
+};

app/en/home/agent-frameworks/oai-agents/set-up-python/page.mdx

@@ -0,0 +1,7 @@
+# Set up Arcade with OpenAI Agents (Python)
+
+Documentation coming soon.
+
+## Overview
+
+This section will contain detailed information about using OpenAI Agents with Python.

app/en/home/agent-frameworks/oai-agents/set-up-typescript/page.mdx

@@ -0,0 +1,7 @@
+# Set up Arcade with OpenAI Agents (TypeScript)
+
+Documentation coming soon.
+
+## Overview
+
+This section will contain detailed information about using OpenAI Agents with TypeScript.