Skip to content

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

docs: improve quickstart selector discoverability

Sushmitha Mallesh83b274bfc5df
diff --git a/docs/components/quickstart/integration-tabs.tsx b/docs/components/quickstart/integration-tabs.tsx
index 27cb67c38..1edad048f 100644
--- a/docs/components/quickstart/integration-tabs.tsx
+++ b/docs/components/quickstart/integration-tabs.tsx
@@ -3,7 +3,8 @@
import Image from 'next/image';
import Link from 'next/link';
import { Tabs, TabsList, TabsTrigger, TabsContent } from '@/components/ui/tabs';
-import { ReactNode } from 'react';
+import { ReactNode, useEffect, useState } from 'react';
+import { createPortal } from 'react-dom';
interface TabConfig {
value: string;
@@ -23,10 +24,17 @@ interface IntegrationTabsProps {
tabs?: TabConfig[];
}
-export function IntegrationTabs({ children, defaultValue, tabs = defaultTabs }: IntegrationTabsProps) {
- return (
- <Tabs defaultValue={defaultValue ?? tabs[0]?.value ?? 'native'} className="not-prose -mt-2">
- <div className="mb-5 flex items-center gap-3">
+function IntegrationTabsHeader({ tabs }: { tabs: TabConfig[] }) {
+ const [portalTarget, setPortalTarget] = useState<HTMLElement | null>(null);
+
+ useEffect(() => {
+ setPortalTarget(document.getElementById('integration-tabs-portal'));
+ }, []);
+
+ const header = (
+ <div className="mt-4 border-t border-fd-border pt-4">
+ <p className="mb-3 text-sm font-medium text-fd-muted-foreground">Choose your integration type · <Link href="/docs/native-tools-vs-mcp" className="text-fd-muted-foreground hover:text-fd-foreground transition-colors underline underline-offset-2">Use this guide to decide</Link></p>
+ <div className="flex items-center gap-3">
<TabsList>
{tabs.map((tab) => (
<TabsTrigger key={tab.value} value={tab.value} className="gap-2">
@@ -52,10 +60,22 @@ export function IntegrationTabs({ children, defaultValue, tabs = defaultTabs }:
</TabsTrigger>
))}
</TabsList>
- <Link href="/docs/native-tools-vs-mcp" className="text-xs text-fd-muted-foreground hover:text-fd-foreground transition-colors">
- Which should I use?
- </Link>
</div>
+ </div>
+ );
+
+ if (portalTarget) {
+ return createPortal(header, portalTarget);
+ }
+
+ // Fallback: render inline if portal target not found
+ return <div className="mb-5">{header}</div>;
+}
+
+export function IntegrationTabs({ children, defaultValue, tabs = defaultTabs }: IntegrationTabsProps) {
+ return (
+ <Tabs defaultValue={defaultValue ?? tabs[0]?.value ?? 'native'} className="not-prose">
+ <IntegrationTabsHeader tabs={tabs} />
{children}
</Tabs>
);
diff --git a/docs/components/quickstart/quickstart-flow.tsx b/docs/components/quickstart/quickstart-flow.tsx
index 0081b4719..bbe8ae260 100644
--- a/docs/components/quickstart/quickstart-flow.tsx
+++ b/docs/components/quickstart/quickstart-flow.tsx
@@ -1,6 +1,7 @@
'use client';
import Image from 'next/image';
+import Link from 'next/link';
import {
createContext,
useContext,
@@ -157,9 +158,10 @@ export function QuickstartFlow({ children }: QuickstartFlowProps) {
return (
<QuickstartContext.Provider value={contextValue}>
- {/* Framework selector */}
+ {/* Framework + integration type selector */}
{frameworks.length > 0 && (
- <div className="not-prose mb-6">
+ <div className="not-prose mb-6 rounded-lg border border-fd-border bg-fd-card/50 p-4">
+ <p className="mb-3 text-sm font-medium text-fd-muted-foreground">Choose your framework</p>
<div className="grid grid-cols-2 gap-3 sm:grid-cols-4">
{frameworks.map((framework) => (
<FrameworkCard
@@ -172,7 +174,16 @@ export function QuickstartFlow({ children }: QuickstartFlowProps) {
onSelect={() => setSelectedId(framework.id)}
/>
))}
+ <Link
+ href="/docs/providers"
+ className="flex items-center gap-3 rounded-lg border border-dashed border-fd-border px-3 py-2.5 text-left transition-all hover:bg-fd-accent/50 hover:border-fd-muted-foreground"
+ >
+ <span className="flex h-6 w-6 shrink-0 items-center justify-center text-fd-muted-foreground">→</span>
+ <span className="text-sm font-medium text-fd-muted-foreground">Other providers</span>
+ </Link>
</div>
+ {/* Portal target for integration tabs header */}
+ <div id="integration-tabs-portal" />
</div>
)}