@devries-cameron20 / composio Mirror · read-only / commits / 8b6da2c92
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 13:15 UTC

fix(docs): Fix duplicate TOC entries in quickstart page

Replace ### headings inside Steps with StepTitle component that renders visually like a heading but uses a div element, preventing fumadocs from extracting them into the Table of Contents. This fixes the issue where each framework tab (OpenAI Agents, Claude Agent SDK, Vercel AI) with Native/MCP variants was adding duplicate "Install", "Configure API Keys", and "Create session and run agent" entries to the TOC. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 27, 2026 at 22:52 UTC 8b6da2c9229bf5b28f428fbffbe87f5935bfa7c0
3 files changed +38 -18
docs/components/step-title.tsx new
+18
@@ -0,0 +1,18 @@
1 +import type { ReactNode } from 'react';
2 +
3 +interface StepTitleProps {
4 + children: ReactNode;
5 +}
6 +
7 +/**
8 + * A visual heading for Steps that doesn't appear in the Table of Contents.
9 + * Use this instead of ### headings inside <Step> when you have multiple
10 + * tabs/frameworks that would otherwise duplicate TOC entries.
11 + */
12 +export function StepTitle({ children }: StepTitleProps) {
13 + return (
14 + <div className="font-semibold text-lg text-fd-foreground mb-3">
15 + {children}
16 + </div>
17 + );
18 +}
docs/content/docs/quickstart.mdx
+18 -18
@@ -15,7 +15,7 @@ Build your first AI agent with Composio Tools.
15
16 <Steps>
17 <Step>
18 -### Install
18 +<StepTitle>Install</StepTitle>
19
20 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
21 <Tab value="Python">
@@ -32,7 +32,7 @@ npm install @composio/core @composio/openai-agents @openai/agents
32 </Step>
33
34 <Step>
35 -### Configure API Keys
35 +<StepTitle>Configure API Keys</StepTitle>
36
37 <Callout type="info">
38 Get your `COMPOSIO_API_KEY` from [Settings](https://platform.composio.dev/settings) and `OPENAI_API_KEY` from [OpenAI](https://platform.openai.com/api-keys).
@@ -45,7 +45,7 @@ OPENAI_API_KEY=your_openai_api_key
45 </Step>
46
47 <Step>
48 -### Create session and run agent
48 +<StepTitle>Create session and run agent</StepTitle>
49
50 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
51 <Tab value="Python">
@@ -161,7 +161,7 @@ readline.close();
161
162 <Steps>
163 <Step>
164 -### Install
164 +<StepTitle>Install</StepTitle>
165
166 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
167 <Tab value="Python">
@@ -178,7 +178,7 @@ npm install dotenv @composio/core @openai/agents zod@3
178 </Step>
179
180 <Step>
181 -### Configure API Keys
181 +<StepTitle>Configure API Keys</StepTitle>
182
183 <Callout type="info">
184 Get your `COMPOSIO_API_KEY` from [Settings](https://platform.composio.dev/settings) and `OPENAI_API_KEY` from [OpenAI](https://platform.openai.com/api-keys).
@@ -191,7 +191,7 @@ OPENAI_API_KEY=your_openai_api_key
191 </Step>
192
193 <Step>
194 -### Create session and run agent
194 +<StepTitle>Create session and run agent</StepTitle>
195
196 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
197 <Tab value="Python">
@@ -325,7 +325,7 @@ readline.close();
325
326 <Steps>
327 <Step>
328 -### Install
328 +<StepTitle>Install</StepTitle>
329
330 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
331 <Tab value="Python">
@@ -342,7 +342,7 @@ npm install dotenv @composio/core @composio/claude-agent-sdk @anthropic-ai/claud
342 </Step>
343
344 <Step>
345 -### Configure API Keys
345 +<StepTitle>Configure API Keys</StepTitle>
346
347 <Callout type="info">
348 Get your `COMPOSIO_API_KEY` from [Settings](https://platform.composio.dev/settings) and `ANTHROPIC_API_KEY` from [Anthropic](https://console.anthropic.com/settings/keys).
@@ -355,7 +355,7 @@ ANTHROPIC_API_KEY=your_anthropic_api_key
355 </Step>
356
357 <Step>
358 -### Create session and run agent
358 +<StepTitle>Create session and run agent</StepTitle>
359
360 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
361 <Tab value="Python">
@@ -475,7 +475,7 @@ readline.close();
475
476 <Steps>
477 <Step>
478 -### Install
478 +<StepTitle>Install</StepTitle>
479
480 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
481 <Tab value="Python">
@@ -492,7 +492,7 @@ npm install dotenv @composio/core @anthropic-ai/claude-agent-sdk
492 </Step>
493
494 <Step>
495 -### Configure API Keys
495 +<StepTitle>Configure API Keys</StepTitle>
496
497 <Callout type="info">
498 Get your `COMPOSIO_API_KEY` from [Settings](https://platform.composio.dev/settings) and `ANTHROPIC_API_KEY` from [Anthropic](https://console.anthropic.com/settings/keys).
@@ -505,7 +505,7 @@ ANTHROPIC_API_KEY=your_anthropic_api_key
505 </Step>
506
507 <Step>
508 -### Create session and run agent
508 +<StepTitle>Create session and run agent</StepTitle>
509
510 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
511 <Tab value="Python">
@@ -673,7 +673,7 @@ readline.close();
673
674 <Steps>
675 <Step>
676 -### Install
676 +<StepTitle>Install</StepTitle>
677
678 ```bash
679 npm install @composio/core @composio/vercel ai @ai-sdk/anthropic
@@ -681,7 +681,7 @@ npm install @composio/core @composio/vercel ai @ai-sdk/anthropic
681 </Step>
682
683 <Step>
684 -### Configure API Keys
684 +<StepTitle>Configure API Keys</StepTitle>
685
686 <Callout type="info">
687 Get your `COMPOSIO_API_KEY` from [Settings](https://platform.composio.dev/settings) and `ANTHROPIC_API_KEY` from [Anthropic](https://console.anthropic.com/settings/keys).
@@ -694,7 +694,7 @@ ANTHROPIC_API_KEY=your_anthropic_api_key
694 </Step>
695
696 <Step>
697 -### Create session and run agent
697 +<StepTitle>Create session and run agent</StepTitle>
698
699 ```typescript
700 // @noErrors
@@ -772,7 +772,7 @@ readline.close();
772
773 <Steps>
774 <Step>
775 -### Install
775 +<StepTitle>Install</StepTitle>
776
777 ```bash
778 npm install dotenv @composio/core ai @ai-sdk/anthropic @ai-sdk/mcp
@@ -780,7 +780,7 @@ npm install dotenv @composio/core ai @ai-sdk/anthropic @ai-sdk/mcp
780 </Step>
781
782 <Step>
783 -### Configure API Keys
783 +<StepTitle>Configure API Keys</StepTitle>
784
785 <Callout type="info">
786 Get your `COMPOSIO_API_KEY` from [Settings](https://platform.composio.dev/settings) and `ANTHROPIC_API_KEY` from [Anthropic](https://console.anthropic.com/settings/keys).
@@ -793,7 +793,7 @@ ANTHROPIC_API_KEY=your_anthropic_api_key
793 </Step>
794
795 <Step>
796 -### Create session and run agent
796 +<StepTitle>Create session and run agent</StepTitle>
797
798 ```typescript
799 // @noErrors
docs/mdx-components.tsx
+2
@@ -12,6 +12,7 @@ import { FrameworkSelector, QuickstartFlow, FrameworkOption } from '@/components
12 import { IntegrationTabs, IntegrationContent } from '@/components/quickstart/integration-tabs';
13 import { ToolTypeFlow, ToolTypeOption } from '@/components/tool-type-selector';
14 import { Figure } from '@/components/figure';
15 +import { StepTitle } from '@/components/step-title';
16 import { Video } from '@/components/video';
17 import { CapabilityCard, CapabilityList } from '@/components/capability-card';
18 import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
@@ -62,6 +63,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
63 CapabilityCard,
64 CapabilityList,
65 ToolkitsLanding,
66 + StepTitle,
67 // Lucide icons - available globally in MDX without imports
68 ShieldCheck,
69 RouteIcon,