Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
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,