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: tidy welcome page, fix playground link, hide ugly Ask AI tab (#3455)

Rahul Tarak9acfa852b2f7
diff --git a/docs/app/(home)/docs/[[...slug]]/page.tsx b/docs/app/(home)/docs/[[...slug]]/page.tsx
index 330e22fe9..705c2f0e7 100644
--- a/docs/app/(home)/docs/[[...slug]]/page.tsx
+++ b/docs/app/(home)/docs/[[...slug]]/page.tsx
@@ -9,6 +9,7 @@ import { getMDXComponents } from '@/mdx-components';
import type { Metadata } from 'next';
import { createRelativeLink } from 'fumadocs-ui/mdx';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
const params = await props.params;
@@ -18,11 +19,21 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const data = page.data as any;
const MDX = data.body;
+ const isLanding = !params.slug || params.slug.length === 0;
return (
- <DocsPage toc={data.toc} full={data.full} footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>
- <DocsTitle>{data.title}</DocsTitle>
- <PageActions path={page.url} />
+ <DocsPage
+ toc={data.toc}
+ full={isLanding ? true : data.full}
+ footer={{ enabled: false }}
+ tableOfContentPopover={{ enabled: false }}
+ >
+ {!isLanding && (
+ <>
+ <DocsTitle>{data.title}</DocsTitle>
+ <PageActions path={page.url} />
+ </>
+ )}
<DocsBody>
<MDX
components={getMDXComponents({
@@ -30,6 +41,7 @@ export default async function Page(props: PageProps<'/docs/[[...slug]]'>) {
a: createRelativeLink(source, page),
})}
/>
+ {!isLanding && <EditOnGitHub path={`docs/content/docs/${page.path}`} />}
</DocsBody>
</DocsPage>
);
diff --git a/docs/app/(home)/docs/changelog/[...slug]/page.tsx b/docs/app/(home)/docs/changelog/[...slug]/page.tsx
index 7bbb7b17a..9bcc53f5a 100644
--- a/docs/app/(home)/docs/changelog/[...slug]/page.tsx
+++ b/docs/app/(home)/docs/changelog/[...slug]/page.tsx
@@ -10,6 +10,7 @@ import { notFound } from 'next/navigation';
import Link from 'next/link';
import { ChevronLeft } from 'lucide-react';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
const mdxComponents = getMDXComponents();
@@ -66,6 +67,9 @@ export default async function ChangelogEntryPage({ params }: PageProps) {
);
})}
</div>
+ {matchingEntries[0] && (
+ <EditOnGitHub path={`docs/content/changelog/${matchingEntries[0].info.path}`} />
+ )}
</DocsBody>
</DocsPage>
);
diff --git a/docs/app/(home)/docs/changelog/page.tsx b/docs/app/(home)/docs/changelog/page.tsx
index 9b9bcf32f..5c7f44d6b 100644
--- a/docs/app/(home)/docs/changelog/page.tsx
+++ b/docs/app/(home)/docs/changelog/page.tsx
@@ -27,6 +27,7 @@ import {
} from 'fumadocs-ui/layouts/docs/page';
import { CopyLink } from '@/components/copy-link';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
const mdxComponents = getMDXComponents();
@@ -54,7 +55,7 @@ export default function ChangelogPage() {
<div className="mb-3 md:absolute md:left-0 md:w-28 md:text-right md:pr-6">
<CopyLink
href={dateToChangelogUrl(entry.date)}
- className="text-sm font-medium text-orange-500 hover:text-orange-600 transition-colors"
+ className="text-sm font-medium text-blue-500 hover:text-blue-600 transition-colors"
>
{formatDate(entry.date)}
</CopyLink>
@@ -77,6 +78,7 @@ export default function ChangelogPage() {
})}
</div>
</div>
+ <EditOnGitHub path="docs/app/(home)/docs/changelog/page.tsx" />
</DocsBody>
</DocsPage>
);
diff --git a/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx b/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx
index d52982d97..d6713e4e3 100644
--- a/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx
+++ b/docs/app/(home)/reference/(v31)/[[...slug]]/page.tsx
@@ -11,6 +11,7 @@ import type { Metadata } from 'next';
import { createRelativeLink } from 'fumadocs-ui/mdx';
import type { ApiPageProps } from 'fumadocs-openapi/ui';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
import { VersionBadge, extractVersionFromPath } from '@/components/version-badge';
interface OpenAPIPageData {
@@ -37,17 +38,20 @@ export default async function Page({
: null;
return (
<DocsPage full footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>
- <h1 className="text-2xl font-semibold mb-4">
- {pageData.title}
- {detectedVersion && (
- <span className="ml-2 align-middle">
- <VersionBadge version={detectedVersion} />
- </span>
- )}
- </h1>
- <PageActions path={page.url} />
+ <div className="mb-4 flex items-start justify-between gap-4">
+ <h1 className="text-2xl font-semibold">
+ {pageData.title}
+ {detectedVersion && (
+ <span className="ml-2 align-middle">
+ <VersionBadge version={detectedVersion} />
+ </span>
+ )}
+ </h1>
+ <PageActions path={page.url} variant="inline" />
+ </div>
<DocsBody>
<APIPage {...apiProps} />
+ <EditOnGitHub path={`docs/content/reference/${page.path}`} />
</DocsBody>
</DocsPage>
);
@@ -68,6 +72,7 @@ export default async function Page({
a: createRelativeLink(referenceSource as any, page),
})}
/>
+ <EditOnGitHub path={`docs/content/reference/${page.path}`} />
</DocsBody>
</DocsPage>
);
diff --git a/docs/app/(home)/reference/v3/[[...slug]]/page.tsx b/docs/app/(home)/reference/v3/[[...slug]]/page.tsx
index ae9ed764b..eb1f08c02 100644
--- a/docs/app/(home)/reference/v3/[[...slug]]/page.tsx
+++ b/docs/app/(home)/reference/v3/[[...slug]]/page.tsx
@@ -11,6 +11,7 @@ import type { Metadata } from 'next';
import { createRelativeLink } from 'fumadocs-ui/mdx';
import type { ApiPageProps } from 'fumadocs-openapi/ui';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
import { VersionBadge, extractVersionFromPath } from '@/components/version-badge';
interface OpenAPIPageData {
@@ -45,17 +46,20 @@ export default async function Page({
: null;
return (
<DocsPage full footer={{ enabled: false }} tableOfContentPopover={{ enabled: false }}>
- <h1 className="text-2xl font-semibold mb-4">
- {pageData.title}
- {detectedVersion && (
- <span className="ml-2 align-middle">
- <VersionBadge version={detectedVersion} />
- </span>
- )}
- </h1>
- <PageActions path={page.url} />
+ <div className="mb-4 flex items-start justify-between gap-4">
+ <h1 className="text-2xl font-semibold">
+ {pageData.title}
+ {detectedVersion && (
+ <span className="ml-2 align-middle">
+ <VersionBadge version={detectedVersion} />
+ </span>
+ )}
+ </h1>
+ <PageActions path={page.url} variant="inline" />
+ </div>
<DocsBody>
<APIPage {...apiProps} />
+ <EditOnGitHub path={`docs/content/reference/${page.path}`} />
</DocsBody>
</DocsPage>
);
@@ -76,6 +80,7 @@ export default async function Page({
a: createRelativeLink(referenceSource as any, page),
})}
/>
+ <EditOnGitHub path={`docs/content/reference/${page.path}`} />
</DocsBody>
</DocsPage>
);
diff --git a/docs/app/(home)/toolkits/[[...slug]]/page.tsx b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
index 7cd6eb0c0..6c8a20ee5 100644
--- a/docs/app/(home)/toolkits/[[...slug]]/page.tsx
+++ b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
@@ -4,6 +4,7 @@ import { getMDXComponents } from '@/mdx-components';
import { ToolkitDetail } from '@/components/toolkits/toolkit-detail';
import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
import { readFile } from 'fs/promises';
import { join } from 'path';
import { getAllToolkits, getToolkitBySlug } from '@/lib/toolkit-data';
@@ -209,11 +210,14 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?
return (
<div>
<a href="/toolkits" className="text-sm text-fd-muted-foreground no-underline hover:text-fd-foreground hover:underline">← All Toolkits</a>
- <h1 className="mt-2 text-3xl font-bold text-fd-foreground">{page.data.title}</h1>
- <PageActions path={page.url} />
- <article className="prose prose-fd max-w-none">
+ <div className="mt-2 flex items-start justify-between gap-4">
+ <h1 className="text-3xl font-bold text-fd-foreground">{page.data.title}</h1>
+ <PageActions path={page.url} variant="inline" />
+ </div>
+ <article className="prose prose-fd mt-6 max-w-none">
<MDXContent components={getMDXComponents()} />
</article>
+ <EditOnGitHub path={`docs/content/toolkits/${page.path}`} />
</div>
);
}
diff --git a/docs/app/global.css b/docs/app/global.css
index 52f2fc721..37354b977 100644
--- a/docs/app/global.css
+++ b/docs/app/global.css
@@ -9,19 +9,20 @@
/* ==========================================================================
COMPOSIO DOCS
- Palette:
- - Light: Content #ffffff, Sidebar #f7f5f2
- - Dark: Content #1a1815, Sidebar #252220
- - Accent: #ea580c (Tailwind orange-600)
+ Palette (synced with ~/composio/landing + ~/composio/composio_dashboard):
+ - Brand: #0007cd / oklch(0.387 0.264 264.1) — deep electric blue
+ - Light: Content #fbfbfb, Card #ffffff
+ - Dark: Content #0f0f0f, Card #1a1a1a
Typography:
- - All text: Inter
- - Code: IBM Plex Mono
+ - All text: ABC Diatype (sans, loaded locally in app/layout.tsx)
+ - Code: JetBrains Mono
========================================================================== */
@theme inline {
- --font-sans: 'Inter', ui-sans-serif, system-ui, sans-serif;
- --radius: 0.625rem;
+ --font-sans: var(--font-sans), ui-sans-serif, system-ui, sans-serif;
+ --font-mono: var(--font-mono), ui-monospace, SFMono-Regular, Menlo, monospace;
+ --radius: 0;
--color-sidebar-ring: var(--sidebar-ring);
--color-sidebar-border: var(--sidebar-border);
--color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
@@ -75,46 +76,47 @@ html {
}
:root {
- /* Brand */
- --composio-orange: #ea580c;
- --composio-sidebar: #f7f5f2;
+ /* Brand — deep electric blue, shared with composio.dev + dashboard */
+ --composio-brand: #0007cd;
+ --composio-orange: var(--composio-brand); /* legacy alias — kept for back-compat */
+ --composio-sidebar: #fbfbfb;
/* Fumadocs overrides - Light */
- --color-fd-background: #ffffff;
- --color-fd-foreground: #171414;
- --color-fd-muted: #f6f4f2;
- --color-fd-muted-foreground: #5c5858; /* Improved contrast */
- --color-fd-border: #e5e0df;
+ --color-fd-background: #fbfbfb;
+ --color-fd-foreground: #0f0f0f;
+ --color-fd-muted: #f3f3f3;
+ --color-fd-muted-foreground: #585858;
+ --color-fd-border: #e5e5e5;
--color-fd-card: #ffffff;
- --color-fd-card-foreground: #171414;
+ --color-fd-card-foreground: #0f0f0f;
--color-fd-popover: #ffffff;
- --color-fd-popover-foreground: #171414;
- --color-fd-primary: #171414;
- --color-fd-primary-foreground: #ffffff;
- --color-fd-secondary: #f6f4f2;
- --color-fd-secondary-foreground: #171414;
- --color-fd-accent: #f6f4f2;
- --color-fd-accent-foreground: #171414;
- --color-fd-ring: #e5e0df;
- --radius: 0.625rem;
- --background: oklch(1 0 0);
- --foreground: oklch(0.145 0 0);
+ --color-fd-popover-foreground: #0f0f0f;
+ --color-fd-primary: #0f0f0f;
+ --color-fd-primary-foreground: #fbfbfb;
+ --color-fd-secondary: #f3f3f3;
+ --color-fd-secondary-foreground: #0f0f0f;
+ --color-fd-accent: #f3f3f3;
+ --color-fd-accent-foreground: #0f0f0f;
+ --color-fd-ring: var(--composio-brand);
+ --radius: 0;
+ --background: oklch(0.985 0 0);
+ --foreground: oklch(0.218 0 0);
--card: oklch(1 0 0);
- --card-foreground: oklch(0.145 0 0);
+ --card-foreground: oklch(0.218 0 0);
--popover: oklch(1 0 0);
- --popover-foreground: oklch(0.145 0 0);
- --primary: oklch(0.205 0 0);
- --primary-foreground: oklch(0.985 0 0);
+ --popover-foreground: oklch(0.218 0 0);
+ --primary: oklch(0.387 0.264 264.1);
+ --primary-foreground: oklch(1 0 0);
--secondary: oklch(0.97 0 0);
- --secondary-foreground: oklch(0.205 0 0);
+ --secondary-foreground: oklch(0.218 0 0);
--muted: oklch(0.97 0 0);
- --muted-foreground: oklch(0.556 0 0);
+ --muted-foreground: oklch(0.51 0 0);
--accent: oklch(0.97 0 0);
- --accent-foreground: oklch(0.205 0 0);
- --destructive: oklch(0.577 0.245 27.325);
- --border: oklch(0.922 0 0);
- --input: oklch(0.922 0 0);
- --ring: oklch(0.708 0 0);
+ --accent-foreground: oklch(0.218 0 0);
+ --destructive: oklch(0.577 0.215 27.3);
+ --border: oklch(0.931 0 0);
+ --input: oklch(0.931 0 0);
+ --ring: oklch(0.387 0.264 264.1);
--chart-1: oklch(0.646 0.222 41.116);
--chart-2: oklch(0.6 0.118 184.704);
--chart-3: oklch(0.398 0.07 227.392);
@@ -131,43 +133,43 @@ html {
}
.dark {
- --composio-sidebar: #131211;
+ --composio-sidebar: #0f0f0f;
/* Fumadocs overrides - Dark */
- --color-fd-background: #131211;
- --color-fd-foreground: #e8e4e0;
- --color-fd-muted: #1e1d1c;
- --color-fd-muted-foreground: #a8a29e; /* Improved contrast */
- --color-fd-border: #2c2a28;
- --color-fd-card: #131211;
- --color-fd-card-foreground: #e8e4e0;
- --color-fd-popover: #252220;
- --color-fd-popover-foreground: #e8e4e0;
- --color-fd-primary: #e8e4e0;
- --color-fd-primary-foreground: #1a1815;
- --color-fd-secondary: #2a2725;
- --color-fd-secondary-foreground: #e8e4e0;
- --color-fd-accent: #2a2725;
- --color-fd-accent-foreground: #e8e4e0;
- --color-fd-ring: #3d3935;
- --background: oklch(0.145 0 0);
+ --color-fd-background: #0f0f0f;
+ --color-fd-foreground: #fbfbfb;
+ --color-fd-muted: #1a1a1a;
+ --color-fd-muted-foreground: #b4b4b4;
+ --color-fd-border: rgba(255, 255, 255, 0.10);
+ --color-fd-card: #141414;
+ --color-fd-card-foreground: #fbfbfb;
+ --color-fd-popover: #1a1a1a;
+ --color-fd-popover-foreground: #fbfbfb;
+ --color-fd-primary: #fbfbfb;
+ --color-fd-primary-foreground: #0f0f0f;
+ --color-fd-secondary: #1a1a1a;
+ --color-fd-secondary-foreground: #fbfbfb;
+ --color-fd-accent: #1a1a1a;
+ --color-fd-accent-foreground: #fbfbfb;
+ --color-fd-ring: var(--composio-brand);
+ --background: oklch(0.159 0 0);
--foreground: oklch(0.985 0 0);
- --card: oklch(0.205 0 0);
+ --card: oklch(0.218 0 0);
--card-foreground: oklch(0.985 0 0);
- --popover: oklch(0.205 0 0);
+ --popover: oklch(0.218 0 0);
--popover-foreground: oklch(0.985 0 0);
- --primary: oklch(0.922 0 0);
- --primary-foreground: oklch(0.205 0 0);
+ --primary: oklch(0.985 0 0);
+ --primary-foreground: oklch(0.218 0 0);
--secondary: oklch(0.269 0 0);
--secondary-foreground: oklch(0.985 0 0);
--muted: oklch(0.269 0 0);
- --muted-foreground: oklch(0.708 0 0);
+ --muted-foreground: oklch(0.706 0 0);
--accent: oklch(0.269 0 0);
--accent-foreground: oklch(0.985 0 0);
- --destructive: oklch(0.704 0.191 22.216);
- --border: oklch(1 0 0 / 5%);
+ --destructive: oklch(0.637 0.208 25.3);
+ --border: oklch(1 0 0 / 10%);
--input: oklch(1 0 0 / 15%);
- --ring: oklch(0.556 0 0);
+ --ring: oklch(0.745 0.128 275);
--chart-1: oklch(0.488 0.243 264.376);
--chart-2: oklch(0.696 0.17 162.48);
--chart-3: oklch(0.769 0.188 70.08);
@@ -361,6 +363,18 @@ textarea:focus-visible {
border-radius: 0 var(--radius) var(--radius) 0;
}
+/* Callouts — muted links, not brand accent */
+[data-fumadocs-body] [data-callout] a:not([data-card]) {
+ color: inherit;
+ text-decoration: underline;
+ text-underline-offset: 2px;
+ text-decoration-color: var(--color-fd-border);
+}
+
+[data-fumadocs-body] [data-callout] a:not([data-card]):hover {
+ text-decoration-color: currentColor;
+}
+
/* ==========================================================================
Header Components
========================================================================== */
@@ -565,6 +579,13 @@ body {
transition: max-width 0.3s ease;
}
+/* Hide Decimal's built-in launcher tab and floating button — we trigger
+ the widget from our own "Ask AI" button in the nav (see ask-ai-button.tsx). */
+.decimal-widget-sidebar-tab,
+.decimal-widget-button {
+ display: none !important;
+}
+
@layer base {
* {
@apply border-border outline-ring/50;
@@ -573,3 +594,48 @@ body {
@apply bg-background text-foreground;
}
}
+
+/* ==========================================================================
+ 404 glitch animation (ported from landing site)
+ ========================================================================== */
+@keyframes glitch-404 {
+ 0%,
+ 3% {
+ text-shadow: none;
+ transform: translate(0);
+ }
+ 6% {
+ text-shadow:
+ 3px 0 var(--composio-brand),
+ -3px 0 #cd0700;
+ transform: translate(-3px, 1px);
+ }
+ 12% {
+ text-shadow:
+ -3px 0 var(--composio-brand),
+ 3px 0 #cd0700;
+ transform: translate(3px, -1px);
+ }
+ 18% {
+ text-shadow:
+ 2px 0 var(--composio-brand),
+ -2px 0 #cd0700;
+ transform: translate(-1px, 2px);
+ }
+ 24% {
+ text-shadow:
+ -1px 0 var(--composio-brand),
+ 1px 0 #cd0700;
+ transform: translate(2px, -1px);
+ }
+ 30%,
+ 100% {
+ text-shadow: none;
+ transform: translate(0);
+ }
+}
+
+.animate-glitch-404 {
+ animation: glitch-404 2.6s ease-out infinite;
+}
+
diff --git a/docs/app/layout.tsx b/docs/app/layout.tsx
index 0d8faa3fe..aff138120 100644
--- a/docs/app/layout.tsx
+++ b/docs/app/layout.tsx
@@ -2,7 +2,8 @@ import { RootProvider } from 'fumadocs-ui/provider/next';
import type { Metadata } from 'next';
import { Analytics } from '@vercel/analytics/next';
import './global.css';
-import { Inter, IBM_Plex_Mono } from 'next/font/google';
+import { JetBrains_Mono } from 'next/font/google';
+import localFont from 'next/font/local';
import { PostHogProvider } from '@/components/posthog-provider';
import { DecimalWidget } from '@/components/decimal-widget';
import CustomSearchDialog from '@/components/custom-search-dialog';
@@ -46,15 +47,17 @@ export const metadata: Metadata = {
},
};
-const inter = Inter({
- weight: ['400', '500', '600', '700'],
- subsets: ['latin'],
+const abcDiatype = localFont({
+ src: [
+ { path: '../public/fonts/ABCDiatype-Regular.woff2', weight: '400', style: 'normal' },
+ { path: '../public/fonts/ABCDiatype-RegularItalic.woff2', weight: '400', style: 'italic' },
+ { path: '../public/fonts/ABCDiatype-Medium.woff2', weight: '500', style: 'normal' },
+ ],
variable: '--font-sans',
display: 'swap',
});
-const ibmPlexMono = IBM_Plex_Mono({
- weight: ['400', '500', '600'],
+const jetbrainsMono = JetBrains_Mono({
subsets: ['latin'],
variable: '--font-mono',
display: 'swap',
@@ -64,7 +67,7 @@ export default function Layout({ children }: LayoutProps<'/'>) {
return (
<html
lang="en"
- className={`${inter.variable} ${ibmPlexMono.variable}`}
+ className={`${abcDiatype.variable} ${jetbrainsMono.variable}`}
suppressHydrationWarning
>
<head>
@@ -111,7 +114,8 @@ export default function Layout({ children }: LayoutProps<'/'>) {
theme={{
defaultTheme: 'light',
attribute: 'class',
- enableSystem: true,
+ enableSystem: false,
+ forcedTheme: 'light',
}}
search={{
SearchDialog: CustomSearchDialog,
diff --git a/docs/app/not-found.tsx b/docs/app/not-found.tsx
index 9dd2ce6e7..6e3ece48e 100644
--- a/docs/app/not-found.tsx
+++ b/docs/app/not-found.tsx
@@ -33,65 +33,62 @@ async function log404ToDatadog(path: string, referer: string | null) {
export default async function NotFound() {
const headersList = await headers();
const referer = headersList.get('referer');
- const path = headersList.get('x-pathname') || headersList.get('x-invoke-path') || 'unknown';
+ const path =
+ headersList.get('x-pathname') || headersList.get('x-invoke-path') || 'unknown';
// Fire and forget - don't block rendering
log404ToDatadog(path, referer);
return (
- <div className="flex min-h-[85vh] flex-col items-center justify-center px-4">
- <div className="relative">
- {/* Subtle gradient glow */}
- <div className="absolute -inset-4 rounded-full bg-gradient-to-r from-fd-primary/20 via-fd-primary/5 to-transparent blur-2xl" />
- <h1 className="relative text-[120px] sm:text-[150px] font-bold leading-none tracking-tighter text-fd-foreground/10 select-none">
- 404
- </h1>
+ <div className="relative flex min-h-[85vh] flex-col items-center justify-center overflow-hidden px-4">
+ {/* Faint giant background 404 */}
+ <div
+ aria-hidden="true"
+ className="pointer-events-none absolute inset-0 flex select-none items-center justify-center text-fd-foreground/[0.04] dark:text-white/[0.04]"
+ style={{
+ fontSize: 'clamp(200px, 30vw, 500px)',
+ fontWeight: 500,
+ lineHeight: 1,
+ letterSpacing: '-0.04em',
+ }}
+ >
+ 404
</div>
- <div className="mt-2 text-center max-w-md">
- <h2 className="text-xl font-semibold text-fd-foreground">
+ {/* Foreground glitch 404 */}
+ <h1
+ aria-label="404 — Page not found"
+ className="animate-glitch-404 relative font-sans text-[96px] font-medium leading-none tracking-tighter text-fd-foreground sm:text-[128px]"
+ >
+ 404
+ </h1>
+
+ <div className="relative mt-6 text-center max-w-md">
+ <h2 className="font-mono text-sm uppercase tracking-[-0.28px] text-fd-muted-foreground">
Page not found
</h2>
- <p className="mt-2 text-fd-muted-foreground text-sm">
- This page doesn&apos;t exist or may have moved.
+ <p className="mt-3 font-mono text-sm leading-relaxed text-fd-muted-foreground">
+ The page you&apos;re looking for doesn&apos;t exist or has moved.
<br />
<span className="text-fd-muted-foreground/70">
- Press <kbd className="mx-1 rounded border border-fd-border bg-fd-muted px-1.5 py-0.5 font-mono text-[10px]">⌘K</kbd> to search.
+ Press{' '}
+ <kbd className="mx-1 rounded border border-fd-border bg-fd-muted px-1.5 py-0.5 font-mono text-[10px]">
+ ⌘K
+ </kbd>{' '}
+ to search.
</span>
</p>
</div>
- {/* Quick links */}
- <div className="mt-8 flex flex-wrap justify-center gap-3">
+ <div className="relative mt-8">
<Link
href="/docs"
- className="inline-flex items-center gap-2 rounded-lg bg-fd-primary px-4 py-2 text-sm font-medium text-fd-primary-foreground transition-colors hover:bg-fd-primary/90"
+ className="group inline-flex items-center gap-1.5 bg-[var(--composio-brand)] px-4 py-2.5 font-mono text-sm uppercase tracking-[-0.28px] text-white no-underline transition-colors hover:bg-[#0006a8]"
+ style={{ color: '#ffffff' }}
>
- Documentation
- </Link>
- <Link
- href="/"
- className="inline-flex items-center gap-2 rounded-lg border border-fd-border bg-fd-background px-4 py-2 text-sm font-medium transition-colors hover:bg-fd-accent"
- >
- Home
+ <span style={{ color: '#ffffff' }}>Back to docs</span>
</Link>
</div>
-
- {/* Secondary links */}
- <nav className="mt-10 flex flex-wrap justify-center gap-x-6 gap-y-2 text-sm text-fd-muted-foreground">
- <Link href="/docs/quickstart" className="hover:text-fd-foreground transition-colors">
- Quickstart
- </Link>
- <Link href="/toolkits" className="hover:text-fd-foreground transition-colors">
- Toolkits
- </Link>
- <Link href="/cookbooks" className="hover:text-fd-foreground transition-colors">
- Cookbooks
- </Link>
- <Link href="/reference" className="hover:text-fd-foreground transition-colors">
- API Reference
- </Link>
- </nav>
</div>
);
}
diff --git a/docs/components/ai-tools-banner.tsx b/docs/components/ai-tools-banner.tsx
index 7fa3e9dac..9950dc70a 100644
--- a/docs/components/ai-tools-banner.tsx
+++ b/docs/components/ai-tools-banner.tsx
@@ -42,15 +42,15 @@ export function AIToolsBanner() {
{/* Shader gradient blobs — same as PromptBanner */}
<div
className="pointer-events-none absolute -left-16 -top-24 h-64 w-64 rounded-full"
- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.15) 0%, rgba(242,139,60,0) 70%)' }}
+ style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.12) 0%, rgba(0,7,205,0) 70%)' }}
/>
<div
className="pointer-events-none absolute right-10 -bottom-20 h-56 w-56 rounded-full"
- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.1) 0%, rgba(242,139,60,0) 70%)' }}
+ style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.08) 0%, rgba(0,7,205,0) 70%)' }}
/>
<div
className="pointer-events-none absolute right-32 -top-16 h-44 w-44 rounded-full"
- style={{ background: 'radial-gradient(circle, rgba(251,191,36,0.08) 0%, rgba(251,191,36,0) 70%)' }}
+ style={{ background: 'radial-gradient(circle, rgba(0,7,205,0.06) 0%, rgba(0,7,205,0) 70%)' }}
/>
<div className="relative flex flex-col gap-3 p-4 sm:px-5 sm:py-4">
{/* Header */}
diff --git a/docs/components/callout.tsx b/docs/components/callout.tsx
new file mode 100644
index 000000000..f1abd9fd0
--- /dev/null
+++ b/docs/components/callout.tsx
@@ -0,0 +1,85 @@
+import type { ReactNode } from 'react';
+import { CircleCheck, CircleX, Lightbulb, TriangleAlert } from 'lucide-react';
+import { cn } from '@/lib/utils';
+
+type CalloutType = 'info' | 'warn' | 'warning' | 'error' | 'success' | 'tip' | 'idea';
+
+interface CalloutProps {
+ type?: CalloutType;
+ title?: ReactNode;
+ children?: ReactNode;
+ className?: string;
+}
+
+type ResolvedType = 'info' | 'warning' | 'error' | 'success' | 'idea';
+
+function resolveType(type: CalloutType = 'info'): ResolvedType {
+ if (type === 'warn') return 'warning';
+ if (type === 'tip') return 'info';
+ return type;
+}
+
+const variants: Record<
+ ResolvedType,
+ { container: string; icon?: typeof TriangleAlert; iconClass?: string }
+> = {
+ info: {
+ container: 'border-fd-border/40 bg-fd-muted/35 text-fd-muted-foreground',
+ },
+ warning: {
+ container: 'border-amber-600/15 bg-amber-500/[0.04] text-fd-muted-foreground',
+ icon: TriangleAlert,
+ iconClass: 'text-amber-600/60',
+ },
+ error: {
+ container: 'border-red-500/15 bg-red-500/[0.04] text-fd-muted-foreground',
+ icon: CircleX,
+ iconClass: 'text-red-500/60',
+ },
+ success: {
+ container: 'border-emerald-600/15 bg-emerald-500/[0.04] text-fd-muted-foreground',
+ icon: CircleCheck,
+ iconClass: 'text-emerald-600/60',
+ },
+ idea: {
+ container: 'border-fd-border/40 bg-fd-muted/35 text-fd-muted-foreground',
+ icon: Lightbulb,
+ iconClass: 'text-fd-muted-foreground/70',
+ },
+};
+
+export function Callout({ type = 'info', title, children, className }: CalloutProps) {
+ const resolved = resolveType(type);
+ const variant = variants[resolved];
+ const Icon = variant.icon;
+
+ return (
+ <div
+ data-callout=""
+ className={cn(
+ 'not-prose my-3 rounded-md border px-3 py-2 text-[0.8125rem] leading-relaxed',
+ variant.container,
+ className,
+ )}
+ >
+ <div className={cn('flex gap-2', Icon ? 'items-start' : '')}>
+ {Icon ? (
+ <Icon className={cn('mt-0.5 size-3.5 shrink-0 stroke-[1.75]', variant.iconClass)} />
+ ) : null}
+ <div className="min-w-0 flex-1">
+ {title ? <p className="mb-1 font-medium text-fd-foreground">{title}</p> : null}
+ <div
+ className={cn(
+ 'prose-no-margin',
+ '[&_a]:text-fd-foreground [&_a]:underline [&_a]:decoration-fd-border [&_a]:underline-offset-2',
+ '[&_a]:hover:decoration-fd-muted-foreground',
+ '[&_code]:text-[0.8125rem] [&_code]:text-fd-foreground/80',
+ )}
+ >
+ {children}
+ </div>
+ </div>
+ </div>
+ </div>
+ );
+}
diff --git a/docs/components/capability-card.tsx b/docs/components/capability-card.tsx
index 5cdd696de..2d050e238 100644
--- a/docs/components/capability-card.tsx
+++ b/docs/components/capability-card.tsx
@@ -13,10 +13,10 @@ export function CapabilityCard({ icon, title, description, href }: CapabilityCar
<Link
href={href}
data-card
- className="block p-6 rounded-xl border border-fd-border bg-fd-card hover:border-orange-500 hover:bg-fd-accent/50 transition-all [text-decoration:none] group focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2"
+ className="block p-6 rounded-xl border border-fd-border bg-fd-card hover:border-blue-500 hover:bg-fd-accent/50 transition-all [text-decoration:none] group focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2"
>
- <div className="text-orange-500 mb-3">{icon}</div>
- <h3 className="text-lg font-semibold text-orange-500 mb-2">{title}</h3>
+ <div className="text-blue-500 mb-3">{icon}</div>
+ <h3 className="text-lg font-semibold text-blue-500 mb-2">{title}</h3>
<p className="text-fd-muted-foreground text-sm leading-relaxed">{description}</p>
</Link>
);
diff --git a/docs/components/connect-flow.tsx b/docs/components/connect-flow.tsx
index a97551a38..10b1b4ed1 100644
--- a/docs/components/connect-flow.tsx
+++ b/docs/components/connect-flow.tsx
@@ -58,7 +58,7 @@ function PopularTab({
onClick={onSelect}
className={`
flex items-center gap-2 rounded-md px-3 py-1.5 text-sm font-medium transition-all whitespace-nowrap
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500
${selected
? 'bg-fd-background text-fd-foreground shadow-sm dark:bg-fd-accent/60 dark:shadow-none'
: 'text-fd-muted-foreground hover:text-fd-foreground'
@@ -154,7 +154,7 @@ export function ConnectFlow({ children }: ConnectFlowProps) {
onKeyDown={(e) => { if (e.key === 'Escape') setDropdownOpen(false); }}
className={`
flex items-center gap-2 rounded-lg border px-3 py-1.5 text-sm font-medium transition-all
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500
${selectedIsOther
? 'border-[var(--composio-orange)] bg-fd-accent/30 text-fd-foreground'
: 'border-fd-border bg-fd-card text-fd-muted-foreground hover:text-fd-foreground hover:bg-fd-accent/50'
diff --git a/docs/components/copy-link.tsx b/docs/components/copy-link.tsx
index 07c2ea8c1..bd53a2bcb 100644
--- a/docs/components/copy-link.tsx
+++ b/docs/components/copy-link.tsx
@@ -22,7 +22,7 @@ export function CopyLink({ href, children, className }: CopyLinkProps) {
return (
<button
onClick={handleCopy}
- className={`inline-flex items-center gap-1.5 group cursor-pointer whitespace-nowrap focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2 rounded ${className}`}
+ className={`inline-flex items-center gap-1.5 group cursor-pointer whitespace-nowrap focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2 rounded ${className}`}
aria-label="Copy link to clipboard"
>
<span>{children}</span>
diff --git a/docs/components/docs-hero.tsx b/docs/components/docs-hero.tsx
new file mode 100644
index 000000000..373fa9dc4
--- /dev/null
+++ b/docs/components/docs-hero.tsx
@@ -0,0 +1,61 @@
+import Image from 'next/image';
+import Link from 'next/link';
+import { ArrowUpRight } from 'lucide-react';
+
+/**
+ * Welcome-page hero — Composio brand language synced with composio.dev.
+ * Full-bleed shader background (Malay's `shader-fallback.jpg` from the
+ * landing site), centered content on top.
+ */
+export function DocsHero() {
+ return (
+ <div className="not-prose relative isolate mb-12 overflow-hidden border border-fd-border">
+ <Image
+ src="/images/hero/shader.jpg"
+ alt=""
+ fill
+ priority
+ sizes="(min-width: 1280px) 1024px, 100vw"
+ className="-z-10 object-cover"
+ />
+ {/* readability scrim — soft white wash on light, soft black wash on dark */}
+ <div
+ aria-hidden="true"
+ className="pointer-events-none absolute inset-0 -z-10 bg-white/30 dark:bg-black/40"
+ />
+
+ <div className="relative flex flex-col items-center gap-6 px-6 py-20 text-center sm:py-24 lg:py-32">
+ <h1 className="text-4xl font-medium leading-[0.95] tracking-[-0.02em] text-fd-foreground md:text-5xl lg:text-[64px]">
+ Composio
+ <br className="sm:hidden" />
+ <span className="sm:ml-3">Documentation</span>
+ </h1>
+ <p className="max-w-[560px] text-base leading-[1.5] text-fd-foreground/80 md:text-lg">
+ Composio powers 1000+ toolkits, tool search, context management,
+ authentication, and a sandboxed workbench to help you build AI agents
+ that turn intent into action.
+ </p>
+ <div className="mt-2 flex flex-wrap items-center justify-center gap-3">
+ <Link
+ href="/docs/quickstart"
+ className="group inline-flex items-center gap-1.5 bg-[var(--composio-brand)] px-5 py-3 font-mono text-sm uppercase tracking-[-0.28px] no-underline transition-colors hover:bg-[#0006a8]"
+ style={{ color: '#ffffff' }}
+ >
+ <span style={{ color: '#ffffff' }}>Get Started</span>
+ <ArrowUpRight aria-hidden="true" className="size-4 transition-transform group-hover:-translate-y-px group-hover:translate-x-px" style={{ color: '#ffffff' }} />
+ </Link>
+ <Link
+ href="https://dashboard.composio.dev/~/project/playground"
+ target="_blank"
+ rel="noopener noreferrer"
+ className="group inline-flex items-center gap-1.5 border border-black/15 bg-white/70 px-5 py-3 font-mono text-sm uppercase tracking-[-0.28px] no-underline backdrop-blur-sm transition-colors hover:bg-white dark:border-white/20 dark:bg-black/40 dark:hover:bg-black/60"
+ style={{ color: 'var(--color-fd-foreground)' }}
+ >
+ <span style={{ color: 'var(--color-fd-foreground)' }}>Playground</span>
+ <ArrowUpRight aria-hidden="true" className="size-4 transition-transform group-hover:-translate-y-px group-hover:translate-x-px" />
+ </Link>
+ </div>
+ </div>
+ </div>
+ );
+}
diff --git a/docs/components/edit-on-github.tsx b/docs/components/edit-on-github.tsx
new file mode 100644
index 000000000..fc93aa704
--- /dev/null
+++ b/docs/components/edit-on-github.tsx
@@ -0,0 +1,32 @@
+import { Edit } from 'lucide-react';
+
+interface EditOnGitHubProps {
+ /**
+ * File path relative to the repository root, e.g. `docs/content/docs/index.mdx`
+ * or `docs/components/toolkits/toolkit-detail.tsx`.
+ */
+ path: string;
+ /** Defaults to the `next` branch. */
+ sha?: string;
+}
+
+/**
+ * "Edit this page on GitHub" link, rendered at the bottom of each docs page.
+ * Links to the source file in the public Composio repo on the configured branch.
+ */
+export function EditOnGitHub({ path, sha = 'next' }: EditOnGitHubProps) {
+ const href = `https://github.com/ComposioHQ/composio/blob/${sha}/${path}`;
+ return (
+ <div className="not-prose mt-12 flex justify-start border-t border-fd-border/60 pt-6">
+ <a
+ href={href}
+ target="_blank"
+ rel="noopener noreferrer"
+ className="inline-flex items-center gap-1.5 text-xs font-medium text-fd-muted-foreground hover:text-fd-foreground transition-colors"
+ >
+ <Edit className="size-3.5" aria-hidden="true" />
+ <span>Edit this page on GitHub</span>
+ </a>
+ </div>
+ );
+}
diff --git a/docs/components/nav-tabs.tsx b/docs/components/nav-tabs.tsx
index 15758245b..af87252a7 100644
--- a/docs/components/nav-tabs.tsx
+++ b/docs/components/nav-tabs.tsx
@@ -27,7 +27,7 @@ export function NavTabs() {
<Link
key={tab.href}
href={tab.href}
- className={`nav-tab focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2 rounded ${isActive(tab.href, tab.exact) ? 'active' : ''}`}
+ className={`nav-tab focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2 rounded ${isActive(tab.href, tab.exact) ? 'active' : ''}`}
>
{tab.label}
</Link>
diff --git a/docs/components/page-actions.tsx b/docs/components/page-actions.tsx
index 03334e33c..18df6dab1 100644
--- a/docs/components/page-actions.tsx
+++ b/docs/components/page-actions.tsx
@@ -1,160 +1,228 @@
'use client';
-import { useState, useCallback } from 'react';
-import { Copy, Check, Loader2, ExternalLink, BotMessageSquare } from 'lucide-react';
-import { Feedback } from './feedback';
-import { toggleDecimalWidget } from './ask-ai-button';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Check, ChevronDown, Copy, ExternalLink, FileText } from 'lucide-react';
interface PageActionsProps {
path: string;
+ /**
+ * 'overlap-title' (default) lifts the button into the row above via a
+ * negative top margin so it lands to the right of `<DocsTitle>`.
+ * 'inline' renders the button as a normal inline-block — use when the
+ * caller already controls layout (e.g. the Toolkits landing header).
+ */
+ variant?: 'overlap-title' | 'inline';
}
+const FALLBACK_ORIGIN = 'https://docs.composio.dev';
+
/**
- * Actions for the current page: copy markdown, open as markdown.
- * Provides AI-friendly access to documentation content.
+ * Single "Copy page" dropdown with three actions:
+ * - Copy page (fetches the .md and writes to clipboard)
+ * - Open in ChatGPT (deep link with a prefilled prompt)
+ * - Open in Claude (deep link with a prefilled prompt)
+ *
+ * Sits to the right of the page title via `not-prose -mt-12 mb-2 flex justify-end`
+ * so it overlaps the row above (next to <DocsTitle>) without ever crashing into
+ * the title text on narrow viewports.
*/
-export function PageActions({ path }: PageActionsProps) {
- const [copyState, setCopyState] = useState<'idle' | 'loading' | 'copied' | 'error'>('idle');
+export function PageActions({ path, variant = 'overlap-title' }: PageActionsProps) {
+ const [open, setOpen] = useState(false);
+ const [copied, setCopied] = useState(false);
+ const wrapperRef = useRef<HTMLDivElement>(null);
- const handleCopy = useCallback(async () => {
- if (copyState === 'loading') return;
- setCopyState('loading');
+ // Close on outside click and Escape.
+ useEffect(() => {
+ if (!open) return;
+ function onClick(e: MouseEvent) {
+ if (wrapperRef.current && !wrapperRef.current.contains(e.target as Node)) {
+ setOpen(false);
+ }
+ }
+ function onKey(e: KeyboardEvent) {
+ if (e.key === 'Escape') setOpen(false);
+ }
+ document.addEventListener('mousedown', onClick);
+ document.addEventListener('keydown', onKey);
+ return () => {
+ document.removeEventListener('mousedown', onClick);
+ document.removeEventListener('keydown', onKey);
+ };
+ }, [open]);
+
+ const absoluteMdUrl =
+ typeof window !== 'undefined'
+ ? `${window.location.origin}${path}.md`
+ : `${FALLBACK_ORIGIN}${path}.md`;
+ const chatgptUrl = `https://chatgpt.com/?hints=search&q=${encodeURIComponent(
+ `Read ${absoluteMdUrl} so I can ask questions about it.`,
+ )}`;
+ const claudeUrl = `https://claude.ai/new?q=${encodeURIComponent(
+ `Read ${absoluteMdUrl} so I can ask questions about it.`,
+ )}`;
+
+ const handleCopy = useCallback(async () => {
try {
const response = await fetch(`${path}.md`);
if (!response.ok) throw new Error('Failed to fetch');
-
const markdown = await response.text();
await navigator.clipboard.writeText(markdown);
-
- setCopyState('copied');
- setTimeout(() => setCopyState('idle'), 2000);
+ setCopied(true);
+ setTimeout(() => setCopied(false), 1500);
+ setTimeout(() => setOpen(false), 400);
} catch {
- setCopyState('error');
- setTimeout(() => setCopyState('idle'), 2000);
+ // best-effort; leave menu open so user can retry
}
- }, [path, copyState]);
-
- const getCopyIcon = () => {
- switch (copyState) {
- case 'loading':
- return (
- <Loader2
- className="size-3.5 animate-spin motion-reduce:animate-none"
- aria-hidden="true"
- />
- );
- case 'copied':
- return (
- <Check
- className="size-3.5 text-emerald-500 dark:text-emerald-400"
- aria-hidden="true"
- />
- );
- case 'error':
- return (
- <Copy
- className="size-3.5 text-red-500 dark:text-red-400"
+ }, [path]);
+
+ return (
+ <div className={variant === 'overlap-title' ? 'not-prose -mt-12 mb-2 flex justify-end' : 'not-prose inline-block'}>
+ <div ref={wrapperRef} className="relative">
+ <button
+ type="button"
+ onClick={() => setOpen((v) => !v)}
+ aria-haspopup="menu"
+ aria-expanded={open}
+ className="inline-flex items-center gap-1.5 px-2.5 py-1.5 text-xs font-medium
+ text-fd-muted-foreground hover:text-fd-foreground
+ bg-fd-secondary/50 hover:bg-fd-secondary
+ border border-fd-border/60
+ transition-colors duration-150 ease-out
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
+ touch-manipulation"
+ style={{ borderRadius: 0 }}
+ >
+ <Copy className="size-3.5" aria-hidden="true" />
+ <span>Copy page</span>
+ <ChevronDown
+ className={`size-3.5 transition-transform duration-150 ${open ? 'rotate-180' : ''}`}
aria-hidden="true"
/>
- );
- default:
- return <Copy className="size-3.5" aria-hidden="true" />;
- }
- };
-
- const getCopyLabel = () => {
- switch (copyState) {
- case 'loading':
- return 'Copying…';
- case 'copied':
- return 'Copied!';
- case 'error':
- return 'Failed';
- default:
- return 'Copy page';
- }
- };
+ </button>
- return (
- <div
- className="not-prose flex flex-wrap items-center gap-1.5 sm:gap-1 mt-2 mb-6"
- role="group"
- aria-label="Page actions"
- >
- {/* Copy Button */}
- <button
- type="button"
- onClick={handleCopy}
- disabled={copyState === 'loading'}
- className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium
- text-fd-muted-foreground hover:text-fd-foreground
- bg-fd-secondary/50 hover:bg-fd-secondary
- rounded-md
- transition-all duration-150 ease-out
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
- disabled:pointer-events-none
- active:scale-[0.98]
- touch-manipulation
- motion-reduce:transition-none motion-reduce:active:scale-100"
- aria-label="Copy page as markdown"
- aria-live="polite"
- >
- <span className="transition-transform duration-150 ease-out">
- {getCopyIcon()}
+ {open && (
+ <div
+ role="menu"
+ className="absolute right-0 z-50 mt-1 w-[280px] border border-fd-border bg-fd-popover text-fd-popover-foreground shadow-lg"
+ style={{ borderRadius: 0 }}
+ >
+ <MenuItem
+ icon={
+ copied ? (
+ <Check className="size-4 text-emerald-500" aria-hidden="true" />
+ ) : (
+ <Copy className="size-4" aria-hidden="true" />
+ )
+ }
+ title={copied ? 'Copied!' : 'Copy page'}
+ subtitle="Copy page as Markdown for LLMs"
+ onClick={handleCopy}
+ />
+ <MenuItem
+ icon={<FileText className="size-4" aria-hidden="true" />}
+ external
+ title="View as Markdown"
+ subtitle="Open the raw .md source in a new tab"
+ href={`${path}.md`}
+ />
+ <MenuItem
+ icon={<ChatGPTMark className="size-4" />}
+ external
+ title="Open in ChatGPT"
+ subtitle="Ask questions about this page"
+ href={chatgptUrl}
+ />
+ <MenuItem
+ icon={<ClaudeMark className="size-4" />}
+ external
+ title="Open in Claude"
+ subtitle="Ask questions about this page"
+ href={claudeUrl}
+ />
+ </div>
+ )}
+ </div>
+ </div>
+ );
+}
+
+interface MenuItemProps {
+ icon: React.ReactNode;
+ title: string;
+ subtitle: string;
+ href?: string;
+ external?: boolean;
+ onClick?: () => void;
+}
+
+function MenuItem({ icon, title, subtitle, href, external, onClick }: MenuItemProps) {
+ const className =
+ 'flex w-full items-start gap-3 px-3 py-2.5 text-left hover:bg-fd-accent hover:text-fd-accent-foreground focus-visible:outline-none focus-visible:bg-fd-accent';
+
+ const content = (
+ <>
+ <span className="mt-0.5 flex size-4 shrink-0 items-center justify-center text-fd-muted-foreground">
+ {icon}
+ </span>
+ <span className="min-w-0 flex-1">
+ <span className="flex items-center gap-1 text-sm font-medium text-fd-foreground">
+ {title}
+ {external && (
+ <ExternalLink className="size-3 text-fd-muted-foreground" aria-hidden="true" />
+ )}
</span>
- <span>{getCopyLabel()}</span>
- </button>
+ <span className="block text-xs text-fd-muted-foreground">{subtitle}</span>
+ </span>
+ </>
+ );
- {/* View Markdown Link */}
+ if (href) {
+ return (
<a
- href={`${path}.md`}
+ href={href}
target="_blank"
rel="noopener noreferrer"
- className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium
- text-fd-muted-foreground hover:text-fd-foreground
- bg-fd-secondary/50 hover:bg-fd-secondary
- rounded-md
- transition-all duration-150 ease-out
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
- active:scale-[0.98]
- touch-manipulation
- motion-reduce:transition-none motion-reduce:active:scale-100"
- aria-label="View page as markdown (opens in new tab)"
+ role="menuitem"
+ className={className}
>
- <ExternalLink className="size-3.5" aria-hidden="true" />
- <span className="hidden sm:inline">View </span>
- <span>Markdown</span>
+ {content}
</a>
+ );
+ }
+ return (
+ <button type="button" role="menuitem" onClick={onClick} className={className}>
+ {content}
+ </button>
+ );
+}
- {/* Divider - hidden on mobile when wrapped */}
- <span
- className="hidden sm:block mx-1 h-4 w-px bg-fd-border/60"
- role="separator"
- aria-orientation="vertical"
- />
-
- {/* Ask AI */}
- <button
- type="button"
- onClick={toggleDecimalWidget}
- className="inline-flex items-center gap-1.5 px-3 py-2 sm:px-2.5 sm:py-1.5 text-xs font-medium
- text-fd-muted-foreground hover:text-fd-foreground
- bg-fd-secondary/50 hover:bg-fd-secondary
- rounded-md
- transition-all duration-150 ease-out
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring focus-visible:ring-offset-2 focus-visible:ring-offset-fd-background
- active:scale-[0.98]
- touch-manipulation
- motion-reduce:transition-none motion-reduce:active:scale-100"
- aria-label="Ask AI"
- >
- <BotMessageSquare className="size-3.5" aria-hidden="true" />
- <span>Ask AI</span>
- </button>
+/** Tiny inline OpenAI/ChatGPT mark (flower-gear), monochrome currentColor. */
+function ChatGPTMark({ className }: { className?: string }) {
+ return (
+ <svg
+ className={className}
+ viewBox="0 0 24 24"
+ fill="currentColor"
+ aria-hidden="true"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path d="M22.282 9.821a5.985 5.985 0 0 0-.516-4.91 6.046 6.046 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a5.985 5.985 0 0 0-3.998 2.9 6.046 6.046 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.051 6.051 0 0 0 6.515 2.9A5.985 5.985 0 0 0 13.26 24a6.056 6.056 0 0 0 5.772-4.206 5.99 5.99 0 0 0 3.997-2.9 6.056 6.056 0 0 0-.747-7.073zM13.26 22.43a4.476 4.476 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.795.795 0 0 0 .392-.681v-6.737l2.02 1.168a.071.071 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494zM3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.771.771 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646zM2.34 7.896a4.485 4.485 0 0 1 2.366-1.973V11.6a.766.766 0 0 0 .388.676l5.815 3.355-2.02 1.168a.077.077 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855-5.833-3.387L15.119 7.2a.076.076 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667zm2.01-3.023-.141-.085-4.774-2.782a.776.776 0 0 0-.785 0L9.409 9.23V6.897a.066.066 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08-4.778 2.758a.795.795 0 0 0-.393.681zm1.097-2.365 2.602-1.5 2.607 1.5v2.999l-2.597 1.5-2.607-1.5z" />
+ </svg>
+ );
+}
- {/* Feedback */}
- <Feedback page={path} />
- </div>
+/** Tiny inline Anthropic Claude mark (asterisk/burst), monochrome currentColor. */
+function ClaudeMark({ className }: { className?: string }) {
+ return (
+ <svg
+ className={className}
+ viewBox="0 0 24 24"
+ fill="currentColor"
+ aria-hidden="true"
+ xmlns="http://www.w3.org/2000/svg"
+ >
+ <path d="M4.709 15.955l4.72-2.647.079-.23-.079-.128h-.23l-.787-.048-2.687-.073-2.331-.097L1.078 12.6l-.582-.74.058-.385.49-.327.701.063 1.55.105 2.327.16 3.376.198 4.802.205-.018-.07L17.16 7.31l.215.06.21.124.214.214.06.21-.124.214-2.31 2.31-.214.215-.06.21-.124.214.124.214.06.21.214.214 2.31 2.31.124.214.06.21-.21.124-.214.06-.215-.06-3.06-2.06-.31-.16-1.06-.06-.124.06-.06.21.124.214 1.95 2.954.214.214.06.21-.06.21-.214.214.214.214.06.21-.06.21.214.214.214.214-.06.21-.21.124-.214.06-3.06-2.06z" />
+ </svg>
);
}
diff --git a/docs/components/provider-card.tsx b/docs/components/provider-card.tsx
index 6f507b289..23f0bb8a2 100644
--- a/docs/components/provider-card.tsx
+++ b/docs/components/provider-card.tsx
@@ -17,7 +17,7 @@ export function ProviderCard({ name, href, logo, logoDark, icon, languages }: Pr
return (
<Link
href={href}
- className="flex items-center gap-5 rounded-lg border border-fd-border bg-fd-card p-5 transition-all hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2"
+ className="flex items-center gap-5 rounded-lg border border-fd-border bg-fd-card p-5 transition-all hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2"
>
<div className="flex h-12 w-12 shrink-0 items-center justify-center">
{logo && logoDark ? (
diff --git a/docs/components/quickstart/framework-selector.tsx b/docs/components/quickstart/framework-selector.tsx
index c724043c1..01836ff55 100644
--- a/docs/components/quickstart/framework-selector.tsx
+++ b/docs/components/quickstart/framework-selector.tsx
@@ -56,7 +56,7 @@ function FrameworkCard({ framework, selected, onSelect }: FrameworkCardProps) {
onClick={onSelect}
className={`
flex flex-col items-start gap-4 rounded-xl border-2 p-5 text-left transition-all
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2
${selected
? 'border-[var(--composio-orange)] bg-fd-card'
: 'border-fd-border bg-fd-card hover:bg-fd-accent/50'
diff --git a/docs/components/quickstart/index.tsx b/docs/components/quickstart/index.tsx
index 3e321ca50..3cbd0d73d 100644
--- a/docs/components/quickstart/index.tsx
+++ b/docs/components/quickstart/index.tsx
@@ -1,4 +1,3 @@
export { FrameworkSelector, frameworks } from './framework-selector';
export { QuickstartFlow, FrameworkOption } from './quickstart-flow';
-export { PromptBanner } from './prompt-banner';
export type { Framework } from './framework-selector';
diff --git a/docs/components/quickstart/prompt-banner.tsx b/docs/components/quickstart/prompt-banner.tsx
deleted file mode 100644
index 0bfeb07aa..000000000
--- a/docs/components/quickstart/prompt-banner.tsx
+++ /dev/null
@@ -1,168 +0,0 @@
-'use client';
-
-import { useState, useRef, useEffect, type ReactNode } from 'react';
-import { Copy, Check } from 'lucide-react';
-
-function detectLang(pre: Element, code: Element | null): string {
- for (const el of [pre, code]) {
- const lang = el?.getAttribute('data-language') ?? el?.getAttribute('data-lang');
- if (lang) return lang;
- }
- const cls = Array.from(code?.classList ?? []).find(c => c.startsWith('language-'));
- if (cls) return cls.replace('language-', '');
- const text = code?.textContent ?? '';
- if (/^(pip|npm|npx|bun|yarn|pnpm) /.test(text.trim())) return 'bash';
- if (text.includes('from dotenv') || text.includes('import asyncio')) return 'python';
- if (text.includes('from "') || text.includes('from "@')) return 'typescript';
- if (text.includes('COMPOSIO_API_KEY=')) return 'bash';
- return '';
-}
-
-function getTabLabel(pre: Element, step: Element): string {
- let el: Element | null = pre.parentElement;
- while (el && el !== step) {
- if (el.getAttribute('role') === 'tabpanel') {
- const tablist = el.parentElement?.querySelector('[role="tablist"]');
- if (tablist) {
- const tabs = tablist.querySelectorAll('[role="tab"]');
- const panels = el.parentElement?.querySelectorAll(':scope > [role="tabpanel"]');
- if (panels) {
- const idx = Array.from(panels).indexOf(el);
- if (idx >= 0 && tabs[idx]) return tabs[idx].textContent?.trim() ?? '';
- }
- }
- return '';
- }
- el = el.parentElement;
- }
- return '';
-}
-
-function extractSteps(stepsEl: Element): string {
- const parts: string[] = [];
- const steps = stepsEl.querySelectorAll('.fd-step');
-
- steps.forEach((step) => {
- const title = step.querySelector('h3, h4, h2, [class*="step-title"], [class*="StepTitle"]');
- const titleText = title?.textContent?.trim();
- if (titleText) parts.push(`### ${titleText}`);
-
- const pres = step.querySelectorAll('pre');
- pres.forEach((pre) => {
- const codeEl = pre.querySelector('code');
- const code = codeEl?.textContent?.trim() ?? '';
- if (!code) return;
-
- const lang = detectLang(pre, codeEl);
- const tabLabel = getTabLabel(pre, step);
-
- if (tabLabel) {
- parts.push(`**${tabLabel}**\n\n\`\`\`${lang}\n${code}\n\`\`\``);
- } else {
- parts.push(`\`\`\`${lang}\n${code}\n\`\`\``);
- }
- });
- });
-
- return parts.join('\n\n');
-}
-
-interface PromptBannerProps {
- children: ReactNode;
-}
-
-export function PromptBanner({ children }: PromptBannerProps) {
- const [copied, setCopied] = useState(false);
- const contentRef = useRef<HTMLDivElement>(null);
- const timerRef = useRef<ReturnType<typeof setTimeout>>(undefined);
-
- useEffect(() => () => { clearTimeout(timerRef.current); }, []);
-
- const handleCopy = async () => {
- const fullMeta = contentRef.current?.innerText ?? '';
-
- const splitMarker = 'Key concepts';
- const splitIdx = fullMeta.indexOf(splitMarker);
- const context = splitIdx > 0 ? fullMeta.slice(0, splitIdx).trim() : fullMeta;
- const rules = splitIdx > 0 ? fullMeta.slice(splitIdx).trim() : '';
-
- let sibling = contentRef.current?.closest('.not-prose')?.nextElementSibling;
- let stepsText = '';
- while (sibling) {
- if (sibling.classList.contains('fd-steps')) {
- stepsText = extractSteps(sibling);
- break;
- }
- sibling = sibling.nextElementSibling;
- }
-
- const parts = [context];
- if (stepsText) parts.push(`## Code\n\n${stepsText}`);
- if (rules) parts.push(rules);
- const fullPrompt = parts.join('\n\n');
-
- try {
- await navigator.clipboard.writeText(fullPrompt);
- clearTimeout(timerRef.current);
- setCopied(true);
- timerRef.current = setTimeout(() => setCopied(false), 2000);
- } catch {
- // Clipboard write failed (e.g. permission denied) — don't show success
- }
- };
-
- return (
- <div className="not-prose mb-6">
- <div className="relative flex flex-wrap items-center justify-between gap-4 overflow-hidden rounded-xl border border-fd-border bg-fd-card px-5 py-4 sm:flex-nowrap sm:gap-6">
- {/* Shader gradient blobs */}
- <div
- className="pointer-events-none absolute -left-16 -top-24 h-64 w-64 rounded-full"
- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.15) 0%, rgba(242,139,60,0) 70%)' }}
- />
- <div
- className="pointer-events-none absolute right-20 -bottom-24 h-48 w-48 rounded-full"
- style={{ background: 'radial-gradient(circle, rgba(242,139,60,0.1) 0%, rgba(242,139,60,0) 70%)' }}
- />
- <div
- className="pointer-events-none absolute left-72 -top-20 h-44 w-44 rounded-full"
- style={{ background: 'radial-gradient(circle, rgba(251,191,36,0.08) 0%, rgba(251,191,36,0) 70%)' }}
- />
-
- {/* Sparkle */}
- <svg className="relative shrink-0" aria-hidden="true" width="28" height="28" viewBox="0 0 28 28" fill="none">
- <path d="M14 2L16.1 11.9L26 14L16.1 16.1L14 26L11.9 16.1L2 14L11.9 11.9L14 2Z" fill="var(--composio-orange)" opacity="0.25"/>
- </svg>
-
- <p className="relative flex-1 text-[15px] text-fd-foreground/70">
- Use skills or copy prompt to get started faster!
- </p>
-
- <div className="relative flex shrink-0 items-center gap-3">
- <a
- href="https://skills.sh/composiohq/skills/composio"
- target="_blank"
- rel="noopener noreferrer"
- className="inline-flex items-center gap-2 rounded-lg border border-[var(--composio-orange)]/30 bg-transparent px-4 py-2 text-sm font-medium text-[var(--composio-orange)] transition-all hover:border-[var(--composio-orange)]/60 hover:bg-[var(--composio-orange)]/5"
- >
- Skills
- <span aria-hidden="true">↗</span>
- </a>
- <button
- type="button"
- onClick={handleCopy}
- className={`inline-flex items-center gap-2 rounded-lg border px-4 py-2 text-sm font-medium transition-all duration-200 active:scale-[0.98] ${copied ? 'border-emerald-500/50 bg-emerald-500/10 text-emerald-500' : 'border-transparent bg-[var(--composio-orange)] text-white shadow-sm hover:brightness-110'}`}
- >
- {copied ? (
- <Check className="h-4 w-4" strokeWidth={3} />
- ) : (
- <Copy className="h-4 w-4" />
- )}
- {copied ? 'Copied!' : 'Copy prompt'}
- </button>
- </div>
- </div>
- {/* Hidden prompt content for copy button */}
- <div ref={contentRef} className="sr-only">{children}</div>
- </div>
- );
-}
diff --git a/docs/components/quickstart/quickstart-flow.tsx b/docs/components/quickstart/quickstart-flow.tsx
index f917bb8e6..f8673fba3 100644
--- a/docs/components/quickstart/quickstart-flow.tsx
+++ b/docs/components/quickstart/quickstart-flow.tsx
@@ -79,7 +79,7 @@ function FrameworkCard({ name, logo, logoDark, selected, onSelect }: FrameworkCa
onClick={onSelect}
className={`
flex items-center gap-3 rounded-lg border px-3 py-2.5 text-left transition-all
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2
${selected
? 'border-[var(--composio-orange)] bg-fd-accent/30'
: 'border-fd-border bg-fd-card hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)]'
diff --git a/docs/components/template-card.tsx b/docs/components/template-card.tsx
index 70e242888..edbf75dfb 100644
--- a/docs/components/template-card.tsx
+++ b/docs/components/template-card.tsx
@@ -25,7 +25,7 @@ export function TemplateCard({
href={href}
target="_blank"
rel="noopener noreferrer"
- className="flex flex-col sm:flex-row items-start gap-8 rounded-xl border border-fd-border bg-fd-card p-8 transition-all hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] [text-decoration:none] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2"
+ className="flex flex-col sm:flex-row items-start gap-8 rounded-xl border border-fd-border bg-fd-card p-8 transition-all hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)] [text-decoration:none] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2"
>
<div className="flex flex-col gap-3 sm:w-1/2 shrink-0 pt-2">
<h3 className="text-xl font-bold text-fd-foreground">{title}</h3>
diff --git a/docs/components/tool-type-selector.tsx b/docs/components/tool-type-selector.tsx
index ba15f7f43..606a467c1 100644
--- a/docs/components/tool-type-selector.tsx
+++ b/docs/components/tool-type-selector.tsx
@@ -76,7 +76,7 @@ function ToolTypeCard({ name, icon, selected, onSelect }: ToolTypeCardProps) {
onClick={onSelect}
className={`
flex items-center gap-3 rounded-lg border px-4 py-3 text-left transition-all
- focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2
+ focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2
${selected
? 'border-[var(--composio-orange)] bg-fd-accent/30'
: 'border-fd-border bg-fd-card hover:bg-fd-accent/50 hover:border-[color-mix(in_srgb,var(--composio-orange)_50%,transparent)]'
diff --git a/docs/components/toolkits/auth-details-section.tsx b/docs/components/toolkits/auth-details-section.tsx
index 2e37dac33..99dca67a1 100644
--- a/docs/components/toolkits/auth-details-section.tsx
+++ b/docs/components/toolkits/auth-details-section.tsx
@@ -1,6 +1,7 @@
'use client';
-import { Key } from 'lucide-react';
+import { ArrowUpRight, Key } from 'lucide-react';
+import Link from 'next/link';
import { TypeTable } from 'fumadocs-ui/components/type-table';
import { Accordion, Accordions } from '@/mdx-components';
import type { AuthConfigDetail, AuthConfigField } from '@/types/toolkit';
@@ -81,9 +82,14 @@ export function AuthDetailsSection({ authConfigDetails, authSchemes, composioMan
Authentication Details
{hasOAuth && (
composioManagedAuthSchemes && composioManagedAuthSchemes.length > 0 ? (
- <span className="rounded bg-green-500/10 px-2 py-0.5 text-xs font-medium text-green-600 dark:text-green-400">
+ <Link
+ href="/toolkits/managed-auth"
+ className="inline-flex items-center gap-1.5 border border-fd-border bg-fd-card px-2 py-0.5 font-mono text-[10px] uppercase tracking-[0.06em] text-fd-foreground transition-colors hover:border-fd-foreground/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-fd-ring"
+ >
+ <span className="size-1.5 rounded-full bg-green-500" aria-hidden="true" />
Composio Managed App available
- </span>
+ <ArrowUpRight className="size-3" aria-hidden="true" />
+ </Link>
) : (
<span className="rounded bg-amber-500/10 px-2 py-0.5 text-xs font-medium text-amber-600 dark:text-amber-400">
Composio Managed App not available
diff --git a/docs/components/toolkits/managed-auth-list.tsx b/docs/components/toolkits/managed-auth-list.tsx
index 558b86578..893ac5f85 100644
--- a/docs/components/toolkits/managed-auth-list.tsx
+++ b/docs/components/toolkits/managed-auth-list.tsx
@@ -49,7 +49,7 @@ function CopySlugButton({ slug }: { slug: string }) {
<button
onClick={handleCopy}
aria-label={`Copy ${slug.toUpperCase()} to clipboard`}
- className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500"
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500"
>
<span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>
{copied ? <Check className="h-3 w-3 text-green-500" aria-hidden="true" /> : <Copy className="h-3 w-3" aria-hidden="true" />}
@@ -158,38 +158,40 @@ export function ManagedAuthList() {
autoComplete="off"
value={search}
onChange={(e) => setSearch(e.target.value)}
- className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-orange-500/50 focus-visible:ring-2 focus-visible:ring-orange-500/20"
+ className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-blue-500/50 focus-visible:ring-2 focus-visible:ring-blue-500/20"
/>
</div>
- {/* Tabs + Copy */}
- <div className="flex items-center justify-between border-b border-fd-border">
- <div className="flex items-center gap-1">
- <button
- onClick={() => setTab('managed')}
- className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
- tab === 'managed'
- ? 'border-green-500 text-fd-foreground'
- : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
- }`}
- >
- <span className="inline-block h-2 w-2 rounded-full bg-green-500" />
- Composio Managed App Available
- <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>
- </button>
- <button
- onClick={() => setTab('unmanaged')}
- className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
- tab === 'unmanaged'
- ? 'border-amber-500 text-fd-foreground'
- : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
- }`}
- >
- <span className="inline-block h-2 w-2 rounded-full bg-amber-500" />
- Requires your own credentials
- <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>
- </button>
- </div>
+ {/* Tabs */}
+ <div className="flex items-center gap-1 border-b border-fd-border">
+ <button
+ onClick={() => setTab('managed')}
+ className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
+ tab === 'managed'
+ ? 'border-green-500 text-fd-foreground'
+ : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
+ }`}
+ >
+ <span className="inline-block h-2 w-2 rounded-full bg-green-500" />
+ Composio Managed App Available
+ <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>
+ </button>
+ <button
+ onClick={() => setTab('unmanaged')}
+ className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
+ tab === 'unmanaged'
+ ? 'border-fd-muted-foreground text-fd-foreground'
+ : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
+ }`}
+ >
+ <span className="inline-block h-2 w-2 rounded-full bg-fd-muted-foreground/60" />
+ Requires your own credentials
+ <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>
+ </button>
+ </div>
+
+ {/* Copy slugs — separate row, aligned with list content */}
+ <div className="flex justify-end">
<CopyButton toolkits={activeList} />
</div>
diff --git a/docs/components/toolkits/toolkit-detail.tsx b/docs/components/toolkits/toolkit-detail.tsx
index e2718faab..3c3eb4432 100644
--- a/docs/components/toolkits/toolkit-detail.tsx
+++ b/docs/components/toolkits/toolkit-detail.tsx
@@ -2,11 +2,12 @@
import { useState, useMemo, useEffect, type ReactNode } from 'react';
import Link from 'next/link';
-import { ExternalLink, Search, Copy, Check, ChevronDown, ChevronRight, ArrowLeft } from 'lucide-react';
+import { Search, Copy, Check, ChevronDown, ChevronRight, ArrowLeft } from 'lucide-react';
import { TypeTable } from 'fumadocs-ui/components/type-table';
import type { Toolkit, Tool, Trigger, ParameterSchema } from '@/types/toolkit';
import { processSchema } from '@/lib/toolkit-schema';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
import { AuthDetailsSection } from '@/components/toolkits/auth-details-section';
import { FaqSection, type FaqItem } from '@/components/toolkits/faq-section';
@@ -317,56 +318,41 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
</Link>
{/* Header */}
- <div className="flex gap-4">
+ <div className="flex flex-wrap items-start justify-between gap-4">
+ <div className="flex min-w-0 flex-1 gap-4">
<ToolkitIcon key={toolkit.slug} toolkit={toolkit} />
<div className="min-w-0 flex-1">
{/* Title row */}
- <div className="flex flex-wrap items-center justify-between gap-2">
- <div className="flex flex-wrap items-center gap-2">
- <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{(toolkit.name?.trim() || toolkit.slug)}</h1>
- <button
- onClick={copySlug}
- className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
- >
- {toolkit.slug.toUpperCase()}
- {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
- </button>
- </div>
+ <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
+ <h1 className="text-xl font-bold tracking-tight text-fd-foreground">{(toolkit.name?.trim() || toolkit.slug)}</h1>
+ <button
+ onClick={copySlug}
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
+ >
+ {toolkit.slug.toUpperCase()}
+ {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
+ </button>
{toolkit.version && (
- <div className="flex items-center gap-2 text-sm text-fd-muted-foreground">
+ <span className="inline-flex items-center gap-1.5 text-xs text-fd-muted-foreground">
<span>Latest version</span>
<button
onClick={copyVersion}
- className="inline-flex items-center gap-1 rounded border border-orange-500/30 bg-orange-500/10 px-1.5 py-0.5 font-mono text-xs text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
>
{toolkit.version}
{versionCopied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
</button>
- </div>
+ </span>
)}
</div>
{/* Description */}
<p className="mt-1.5 text-sm text-fd-muted-foreground">{toolkit.description}</p>
-
- {/* Actions */}
- <div className="mt-4 flex flex-wrap items-center justify-between gap-2">
- <div className="flex flex-wrap items-center gap-2">
- <Link
- href={`https://platform.composio.dev/marketplace/${toolkit.slug}`}
- target="_blank"
- rel="noopener noreferrer"
- className="inline-flex items-center gap-1.5 rounded-md border border-orange-500/30 bg-orange-500/10 px-3 py-1.5 text-sm font-medium text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
- >
- Try {(toolkit.name?.trim() || toolkit.slug)}
- <ExternalLink className="h-3.5 w-3.5" />
- </Link>
- </div>
- </div>
-
- {/* Page actions */}
- <PageActions path={path} />
</div>
+ </div>
+
+ {/* Page actions */}
+ <PageActions path={path} variant="inline" />
</div>
{/* Authentication Details */}
@@ -392,7 +378,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
>
Tools ({tools.length})
{activeTab === 'tools' && (
- <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />
+ <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-blue-500" />
)}
</button>
{triggers.length > 0 && (
@@ -406,7 +392,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
>
Triggers ({triggers.length})
{activeTab === 'triggers' && (
- <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-orange-500" />
+ <span className="absolute bottom-0 left-0 right-0 h-0.5 bg-blue-500" />
)}
</button>
)}
@@ -423,7 +409,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
autoComplete="off"
value={toolSearch}
onChange={(e) => setToolSearch(e.target.value)}
- className="h-9 w-full rounded-md border border-fd-border bg-fd-background pl-9 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-orange-500/50 focus-visible:ring-2 focus-visible:ring-orange-500/20"
+ className="h-9 w-full rounded-md border border-fd-border bg-fd-background pl-9 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-blue-500/50 focus-visible:ring-2 focus-visible:ring-blue-500/20"
/>
</div>
@@ -454,6 +440,7 @@ export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDe
</div>
</div>
)}
+ <EditOnGitHub path="docs/components/toolkits/toolkit-detail.tsx" />
</div>
);
}
diff --git a/docs/components/toolkits/toolkits-landing.tsx b/docs/components/toolkits/toolkits-landing.tsx
index 2f01b58d5..5ad6b9216 100644
--- a/docs/components/toolkits/toolkits-landing.tsx
+++ b/docs/components/toolkits/toolkits-landing.tsx
@@ -59,7 +59,7 @@ function CopySlugButton({ slug }: { slug: string }) {
<button
onClick={handleCopy}
aria-label={`Copy ${slug.toUpperCase()} to clipboard`}
- className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500"
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500"
>
<span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>
{copied ? <Check className="h-3 w-3 text-green-500" aria-hidden="true" /> : <Copy className="h-3 w-3" aria-hidden="true" />}
@@ -154,11 +154,11 @@ export function ToolkitsLanding() {
<p className="mt-1.5 text-sm text-fd-muted-foreground sm:mt-2 sm:text-base">
Browse {toolkits.length} toolkits supported by Composio
</p>
- <PageActions path="/toolkits" />
</div>
<div className="flex flex-wrap items-center gap-2">
+ <PageActions path="/toolkits" variant="inline" />
<a
- href="https://platform.composio.dev/auth?next_page=%2Ftool-router"
+ href="https://dashboard.composio.dev/~/project/playground"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-1.5 rounded-md border border-fd-border bg-fd-background px-3 py-1.5 text-sm font-medium text-fd-foreground transition-colors hover:bg-fd-accent"
@@ -170,7 +170,7 @@ export function ToolkitsLanding() {
href="https://request.composio.dev/boards/tool-requests"
target="_blank"
rel="noopener noreferrer"
- className="inline-flex items-center gap-1.5 rounded-md border border-orange-500/30 bg-orange-500/10 px-3 py-1.5 text-sm font-medium text-orange-600 transition-colors hover:bg-orange-500/20 dark:text-orange-400"
+ className="inline-flex items-center gap-1.5 rounded-md border border-blue-500/30 bg-blue-500/10 px-3 py-1.5 text-sm font-medium text-blue-600 transition-colors hover:bg-blue-500/20 dark:text-blue-400"
>
<Grip className="h-3.5 w-3.5" />
Request Tools
@@ -196,7 +196,7 @@ export function ToolkitsLanding() {
autoComplete="off"
value={search}
onChange={(e) => setSearch(e.target.value)}
- className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-orange-500/50 focus-visible:ring-2 focus-visible:ring-orange-500/20"
+ className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-blue-500/50 focus-visible:ring-2 focus-visible:ring-blue-500/20"
/>
</div>
diff --git a/docs/components/top-nav.tsx b/docs/components/top-nav.tsx
index f952ef2a6..cef1b2d16 100644
--- a/docs/components/top-nav.tsx
+++ b/docs/components/top-nav.tsx
@@ -51,7 +51,7 @@ export function TopNav() {
<Link
key={item.href}
href={item.href}
- className={`px-3 py-1.5 text-sm font-medium rounded-md transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500 focus-visible:ring-offset-2 ${
+ className={`px-3 py-1.5 text-sm font-medium rounded-md transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-500 focus-visible:ring-offset-2 ${
isActive(item.href)
? 'text-[var(--composio-orange)]'
: 'text-fd-muted-foreground hover:text-fd-foreground'
diff --git a/docs/content/changelog/04-24-26-trigger-disabled-event.mdx b/docs/content/changelog/04-24-26-trigger-disabled-event.mdx
index d4d3d43d6..696d04bad 100644
--- a/docs/content/changelog/04-24-26-trigger-disabled-event.mdx
+++ b/docs/content/changelog/04-24-26-trigger-disabled-event.mdx
@@ -21,7 +21,7 @@ The event does not fire when you disable a trigger yourself — neither through
## Subscribe
-Add `composio.trigger.disabled` to your subscription's `enabled_events` — via the [dashboard webhook settings](https://platform.composio.dev?next_page=/settings/webhook) or the Webhook Subscriptions API:
+Add `composio.trigger.disabled` to your subscription's `enabled_events` — via the [dashboard webhook settings](https://dashboard.composio.dev/~/project/settings/webhook) or the Webhook Subscriptions API:
```bash
curl -X PATCH https://backend.composio.dev/api/v3/webhook_subscriptions/ws_your-subscription-id \
diff --git a/docs/content/docs/auth-configuration/white-labeling.mdx b/docs/content/docs/auth-configuration/white-labeling.mdx
index 65ed56b53..b21cc65cf 100644
--- a/docs/content/docs/auth-configuration/white-labeling.mdx
+++ b/docs/content/docs/auth-configuration/white-labeling.mdx
@@ -26,7 +26,7 @@ The Connect Link is the hosted page your users see when connecting their account
To replace it with your own branding:
-1. Go to **Project Settings** → [**Auth Screen**](https://platform.composio.dev?next_page=/settings/auth-screen)
+1. Go to **Project Settings** → [**Auth Screen**](https://dashboard.composio.dev/~/project/settings/auth-screen)
2. Upload your **Logo** and set your **App Title**
This applies to all Connect Link flows across all toolkits. Each project has one logo and app title, so if you need different branding per product, use separate projects.
diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdx
index 4036d88c2..2fcbba2cb 100644
--- a/docs/content/docs/common-faq.mdx
+++ b/docs/content/docs/common-faq.mdx
@@ -49,7 +49,7 @@ Create a new session when the config changes: different toolkits, different auth
<Accordions>
<Accordion title="Where can I see all available toolkits?">
-You can browse all toolkits on the [Toolkits page](/toolkits) in the docs or in the [Composio dashboard](https://platform.composio.dev?next_page=/marketplace). Both list every supported app along with available auth schemes and tools.
+You can browse all toolkits on the [Toolkits page](/toolkits) in the docs or in the [Composio dashboard](https://dashboard.composio.dev/~/project/toolkits). Both list every supported app along with available auth schemes and tools.
</Accordion>
<Accordion title="What toolkits are available by default in a session?">
@@ -267,7 +267,7 @@ See [Connected accounts](/docs/auth-configuration/connected-accounts#get-account
</Accordion>
<Accordion title="Where can I find execution logs?">
-Every tool execution is logged in the [Composio dashboard](https://platform.composio.dev?next_page=/logs/tools) under **Logs > Tools**. Each execution response includes a `log_id` you can use to look up detailed request and response data. Trigger delivery attempts are logged separately under **Logs > Triggers**.
+Every tool execution is logged in the [Composio dashboard](https://dashboard.composio.dev/~/project/logs) under **Logs > Tools**. Each execution response includes a `log_id` you can use to look up detailed request and response data. Trigger delivery attempts are logged separately under **Logs > Triggers**.
See [Troubleshooting tools](/docs/troubleshooting/tools) for how to use logs to debug failed executions.
</Accordion>
diff --git a/docs/content/docs/configuring-sessions.mdx b/docs/content/docs/configuring-sessions.mdx
index 4378ddd3c..70aa8c70b 100644
--- a/docs/content/docs/configuring-sessions.mdx
+++ b/docs/content/docs/configuring-sessions.mdx
@@ -518,7 +518,7 @@ console.log(mcp.url);
</Tab>
</Tabs>
-For framework examples, see provider-specific documentation like [OpenAI Agents](/docs/providers/openai-agents) or [Vercel AI SDK](/docs/providers/vercel).
+For framework examples, see provider-specific documentation like [OpenAI](/docs/providers/openai) or [Vercel AI SDK](/docs/providers/vercel).
### tools()
diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdx
index 51edeb62e..85a267489 100644
--- a/docs/content/docs/index.mdx
+++ b/docs/content/docs/index.mdx
@@ -4,99 +4,20 @@ description: Composio powers 1000+ toolkits, tool search, context management, au
keywords: [getting started, introduction]
---
-Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
-
-<Cards>
- <Card
- title="Tutorial: Build a chat app"
- href="/cookbooks/chat-app"
- description="Build a Next.js chat app where your agent can discover and use tools across 1000+ apps."
- />
- <Card
- title="How Composio works"
- href="/docs/how-composio-works"
- description="See what happens under the hood when your agent searches, authenticates, and executes a tool."
- />
-</Cards>
-
-## Get Started
-
-<AIToolsBanner />
-
-<Cards className="grid-cols-1">
- <Card
- icon={<Rocket />}
- title="Quickstart"
- href="/docs/quickstart"
- description="Install the SDK, connect an app, and run your first tool call in 5 minutes."
- />
-</Cards>
-
-## Explore
-
-<Cards>
- <Card
- icon={<Wrench />}
- title="Toolkits"
- href="/toolkits"
- description="Browse 1000+ toolkits across GitHub, Gmail, Slack, Notion, and more."
- />
- <Card
- icon={<Play />}
- title="Playground"
- href="https://platform.composio.dev/auth?next_page=%2Ftool-router"
- description="Try Composio in your browser without writing any code."
- />
-</Cards>
+<DocsHero />
## Providers
Composio works with any AI framework. Pick your preferred SDK:
<ProviderGrid>
- <ProviderCard name="Claude Agent SDK" href="/docs/providers/claude-agent-sdk" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
<ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="OpenAI Agents" href="/docs/providers/openai-agents" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
<ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="Google Gemini" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
<ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />
+ <ProviderCard name="Google" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
<ProviderCard name="LangChain" href="/docs/providers/langchain" logo="/images/providers/langchain-logo.svg" logoDark="/images/providers/langchain-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="LangGraph" href="/docs/providers/langgraph" logo="/images/providers/langgraph-logo.svg" languages={["Python"]} />
<ProviderCard name="CrewAI" href="/docs/providers/crewai" logo="/images/providers/crewai-logo.svg" languages={["Python"]} />
<ProviderCard name="LlamaIndex" href="/docs/providers/llamaindex" logo="/images/providers/llamaIndex-logo.svg" languages={["Python", "TypeScript"]} />
<ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" logoDark="/images/providers/mastra-logo-dark.svg" languages={["TypeScript"]} />
<ProviderCard name="Build your own" href="/docs/providers/custom-providers" icon={<Blocks size={32} />} languages={["Python", "TypeScript"]} />
</ProviderGrid>
-
-## Features
-
-<Cards>
- <Card
- icon={<Key />}
- title="Authentication"
- href="/docs/authentication"
- description="OAuth, API keys, and custom auth flows"
- />
- <Card
- icon={<Zap />}
- title="Triggers"
- href="/docs/triggers"
- description="Subscribe to external events and trigger workflows"
- />
- <Card
- icon={<Terminal />}
- title="CLI"
- href="/docs/cli"
- description="Manage toolkits, execute tools, and generate type-safe code from the terminal"
- />
- <Card
- icon={<Palette />}
- title="White Labeling"
- href="/docs/white-labeling-authentication"
- description="Customize auth screens with your branding"
- />
-</Cards>
-
-## Community
-
-Join our [Discord](https://discord.gg/composio) community!
diff --git a/docs/content/docs/meta.json b/docs/content/docs/meta.json
index 708613507..fb6ff75a9 100644
--- a/docs/content/docs/meta.json
+++ b/docs/content/docs/meta.json
@@ -5,7 +5,6 @@
"quickstart",
"providers",
"cli",
- "claude-code-plugin",
"---Core Concepts---",
"how-composio-works",
"users-and-sessions",
diff --git a/docs/content/docs/projects.mdx b/docs/content/docs/projects.mdx
index d9fd88c61..d09c0a2c2 100644
--- a/docs/content/docs/projects.mdx
+++ b/docs/content/docs/projects.mdx
@@ -25,7 +25,7 @@ Common reasons to use multiple projects:
## Managing projects
-You can manage projects from the [dashboard](https://platform.composio.dev?next_page=/settings) or via the API using an **organization API key** (`x-org-api-key`).
+You can manage projects from the [dashboard](https://dashboard.composio.dev/~/org/) or via the API using an **organization API key** (`x-org-api-key`).
<Callout type="info">
Project management endpoints use the `x-org-api-key` header, not the regular `x-api-key`. You can find your org API key in the dashboard under **Settings > Organization**.
@@ -90,7 +90,7 @@ curl -X PATCH https://backend.composio.dev/api/v3.1/org/project/config \
Notable security setting:
- `require_mcp_api_key`: when `true`, MCP server requests must include a valid `x-api-key` header. This defaults to `true` for organizations created on or after March 5, 2026.
-You can also view and update these from **Settings > Project Settings** in the [dashboard](https://platform.composio.dev?next_page=/settings). See the [Projects API reference](/reference/api-reference/projects) for all available settings.
+You can also view and update these from **Settings > Project Settings** in the [dashboard](https://dashboard.composio.dev/~/project/settings/general). See the [Projects API reference](/reference/api-reference/projects) for all available settings.
## What to read next
diff --git a/docs/content/docs/providers/anthropic.mdx b/docs/content/docs/providers/anthropic.mdx
index 958c95149..2f212d089 100644
--- a/docs/content/docs/providers/anthropic.mdx
+++ b/docs/content/docs/providers/anthropic.mdx
@@ -1,14 +1,19 @@
---
title: Anthropic
description: Build an agent with Claude and enable it to use 1000+ tools with Composio.
-keywords: [claude, messages api]
+keywords: [claude, messages api, claude agent sdk, agents sdk]
---
-The Anthropic Provider transforms Composio tools into a format compatible with the [Claude Messages API](https://docs.anthropic.com/en/api/messages).
+Composio integrates with Anthropic through the [Claude Messages API](https://docs.anthropic.com/en/api/messages) and the [Claude Agent SDK](https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk). Pick the tab that matches your integration.
-<Callout type="info">
-Looking for the Claude Agent SDK? See the [Claude Agent SDK](/docs/providers/claude-agent-sdk) provider page.
-</Callout>
+<IntegrationTabs tabs={[
+ { value: "messages", label: "Messages API" },
+ { value: "agent-sdk", label: "Claude Agent SDK" },
+]}>
+
+<IntegrationContent value="messages">
+
+The Anthropic Provider transforms Composio tools into a format compatible with the Claude Messages API.
<Steps>
<Step>
@@ -32,7 +37,7 @@ npm install @composio/core @composio/anthropic @anthropic-ai/sdk
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
</Callout>
```txt title=".env"
@@ -149,6 +154,116 @@ for (const block of response.content) {
</Step>
</Steps>
+</IntegrationContent>
+
+<IntegrationContent value="agent-sdk">
+
+The Claude Agent SDK provider transforms Composio tools into tools compatible with the Claude Agent SDK.
+
+<Steps>
+<Step>
+**Install**
+
+<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
+<Tab value="Python">
+```bash
+pip install composio composio_claude_agent_sdk claude-agent-sdk
+```
+</Tab>
+<Tab value="TypeScript">
+```bash
+npm install @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk
+```
+</Tab>
+</Tabs>
+</Step>
+
+<Step>
+**Configure API Keys**
+
+<Callout type="info">
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
+</Callout>
+
+```txt title=".env"
+COMPOSIO_API_KEY=xxxxxxxxx
+ANTHROPIC_API_KEY=xxxxxxxxx
+```
+</Step>
+
+<Step>
+**Create session and run**
+
+<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
+<Tab value="Python">
+```python
+import asyncio
+from composio import Composio
+from composio_claude_agent_sdk import ClaudeAgentSDKProvider
+from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server
+
+composio = Composio(provider=ClaudeAgentSDKProvider())
+
+# Create a session for your user
+session = composio.create(user_id="user_123")
+tools = session.tools()
+tool_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)
+
+async def main():
+ options = ClaudeAgentOptions(
+ system_prompt="You are a helpful assistant",
+ permission_mode="bypassPermissions",
+ mcp_servers={"composio": tool_server},
+ )
+
+ async with ClaudeSDKClient(options=options) as client:
+ await client.query("Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")
+ async for msg in client.receive_response():
+ print(msg)
+
+asyncio.run(main())
+```
+</Tab>
+<Tab value="TypeScript">
+```js
+import { Composio } from '@composio/core';
+import { ClaudeAgentSDKProvider } from '@composio/claude-agent-sdk';
+import { createSdkMcpServer, query } from '@anthropic-ai/claude-agent-sdk';
+
+const composio = new Composio({
+ provider: new ClaudeAgentSDKProvider(),
+});
+
+// Create a session for your user
+const session = await composio.create("user_123");
+const tools = await session.tools();
+const toolServer = createSdkMcpServer({
+ name: "composio",
+ version: "1.0.0",
+ tools: tools,
+});
+
+for await (const content of query({
+ prompt: "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",
+ options: {
+ mcpServers: { composio: toolServer },
+ permissionMode: "bypassPermissions",
+ },
+})) {
+ if (content.type === "assistant") {
+ console.log("Claude:", content.message);
+ }
+}
+```
+</Tab>
+</Tabs>
+</Step>
+</Steps>
+
+</IntegrationContent>
+
+</IntegrationTabs>
+
## Multi-turn chat
For multi-turn apps, create the session once and reuse it across requests with `composio.use()`:
diff --git a/docs/content/docs/providers/autogen.mdx b/docs/content/docs/providers/autogen.mdx
index 8ec1e9dea..d28e09305 100644
--- a/docs/content/docs/providers/autogen.mdx
+++ b/docs/content/docs/providers/autogen.mdx
@@ -19,7 +19,7 @@ pip install composio composio_autogen autogen-agentchat
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
</Callout>
```txt title=".env"
diff --git a/docs/content/docs/providers/claude-agent-sdk.mdx b/docs/content/docs/providers/claude-agent-sdk.mdx
deleted file mode 100644
index 14f194843..000000000
--- a/docs/content/docs/providers/claude-agent-sdk.mdx
+++ /dev/null
@@ -1,111 +0,0 @@
----
-title: Claude Agent SDK
-description: Build an agent with the Claude Agent SDK and enable it to use 1000+ tools with Composio.
-keywords: [claude agent sdk, claude code]
----
-
-The Claude Agent SDK provider transforms Composio tools into tools compatible with the [Claude Agent SDK](https://docs.anthropic.com/en/docs/agents-and-tools/claude-agent-sdk).
-
-<Callout type="info">
-Looking for the Claude Messages API? See the [Anthropic](/docs/providers/anthropic) provider page.
-</Callout>
-
-<Steps>
-<Step>
-**Install**
-
-<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
-<Tab value="Python">
-```bash
-pip install composio composio_claude_agent_sdk claude-agent-sdk
-```
-</Tab>
-<Tab value="TypeScript">
-```bash
-npm install @composio/core @composio/claude-agent-sdk @anthropic-ai/claude-agent-sdk
-```
-</Tab>
-</Tabs>
-</Step>
-
-<Step>
-**Configure API Keys**
-
-<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
-</Callout>
-
-```txt title=".env"
-COMPOSIO_API_KEY=xxxxxxxxx
-ANTHROPIC_API_KEY=xxxxxxxxx
-```
-</Step>
-
-<Step>
-**Create session and run**
-
-<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
-<Tab value="Python">
-```python
-import asyncio
-from composio import Composio
-from composio_claude_agent_sdk import ClaudeAgentSDKProvider
-from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, create_sdk_mcp_server
-
-composio = Composio(provider=ClaudeAgentSDKProvider())
-
-# Create a session for your user
-session = composio.create(user_id="user_123")
-tools = session.tools()
-tool_server = create_sdk_mcp_server(name="composio", version="1.0.0", tools=tools)
-
-async def main():
- options = ClaudeAgentOptions(
- system_prompt="You are a helpful assistant",
- permission_mode="bypassPermissions",
- mcp_servers={"composio": tool_server},
- )
-
- async with ClaudeSDKClient(options=options) as client:
- await client.query("Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")
- async for msg in client.receive_response():
- print(msg)
-
-asyncio.run(main())
-```
-</Tab>
-<Tab value="TypeScript">
-```js
-import { Composio } from '@composio/core';
-import { ClaudeAgentSDKProvider } from '@composio/claude-agent-sdk';
-import { createSdkMcpServer, query } from '@anthropic-ai/claude-agent-sdk';
-
-const composio = new Composio({
- provider: new ClaudeAgentSDKProvider(),
-});
-
-// Create a session for your user
-const session = await composio.create("user_123");
-const tools = await session.tools();
-const toolServer = createSdkMcpServer({
- name: "composio",
- version: "1.0.0",
- tools: tools,
-});
-
-for await (const content of query({
- prompt: "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",
- options: {
- mcpServers: { composio: toolServer },
- permissionMode: "bypassPermissions",
- },
-})) {
- if (content.type === "assistant") {
- console.log("Claude:", content.message);
- }
-}
-```
-</Tab>
-</Tabs>
-</Step>
-</Steps>
diff --git a/docs/content/docs/providers/crewai.mdx b/docs/content/docs/providers/crewai.mdx
index f70026274..de2042248 100644
--- a/docs/content/docs/providers/crewai.mdx
+++ b/docs/content/docs/providers/crewai.mdx
@@ -19,7 +19,7 @@ pip install composio composio_crewai crewai
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
</Callout>
```txt title=".env"
diff --git a/docs/content/docs/providers/google-adk.mdx b/docs/content/docs/providers/google-adk.mdx
deleted file mode 100644
index 80353baae..000000000
--- a/docs/content/docs/providers/google-adk.mdx
+++ /dev/null
@@ -1,82 +0,0 @@
----
-title: Google ADK
-description: Build an agent with Google ADK and enable it to use 1000+ tools with Composio.
-keywords: [google adk, agent development kit, gemini]
----
-
-The Google ADK provider transforms Composio tools into Google ADK's [FunctionTool](https://google.github.io/adk-docs/) format for use with Google ADK agents.
-
-<Callout type="info">
-Looking for Gemini without ADK? See the [Google Generative AI](/docs/providers/google) provider page.
-</Callout>
-
-<Steps>
-<Step>
-**Install**
-
-```bash
-pip install composio composio_google_adk google-adk
-```
-</Step>
-
-<Step>
-**Configure API Keys**
-
-<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
-</Callout>
-
-```txt title=".env"
-COMPOSIO_API_KEY=xxxxxxxxx
-GOOGLE_API_KEY=xxxxxxxxx
-```
-</Step>
-
-<Step>
-**Create session and run**
-
-```python
-from composio import Composio
-from composio_google_adk import GoogleAdkProvider
-from google.adk.agents import Agent
-from google.adk.runners import Runner
-from google.adk.sessions import InMemorySessionService
-from google.genai import types
-
-composio = Composio(provider=GoogleAdkProvider())
-
-# Create a session for your user
-session = composio.create(user_id="user_123")
-tools = session.tools()
-
-agent = Agent(
- name="email_agent",
- model="gemini-3-pro-preview",
- instruction="You are an AI agent that sends emails using Gmail.",
- tools=tools,
-)
-
-session_service = InMemorySessionService()
-adk_session = session_service.create_session_sync(
- app_name="email_agent",
- user_id="user_123",
- session_id="session_1",
-)
-runner = Runner(
- agent=agent,
- app_name="email_agent",
- session_service=session_service,
-)
-
-content = types.Content(
- role="user",
- parts=[types.Part(text="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")],
-)
-
-events = runner.run(user_id="user_123", session_id="session_1", new_message=content)
-for event in events:
- if event.is_final_response() and event.content and event.content.parts:
- print(event.content.parts[0].text)
-```
-</Step>
-</Steps>
diff --git a/docs/content/docs/providers/google.mdx b/docs/content/docs/providers/google.mdx
index ac38db3c6..548174662 100644
--- a/docs/content/docs/providers/google.mdx
+++ b/docs/content/docs/providers/google.mdx
@@ -1,10 +1,19 @@
---
-title: Google Generative AI
-description: Build an agent with Gemini and enable it to use 1000+ tools with Composio.
-keywords: [gemini, google generative ai, google genai]
+title: Google
+description: Build an agent with Gemini or Google ADK and enable it to use 1000+ tools with Composio.
+keywords: [gemini, google generative ai, google genai, google adk, agent development kit]
---
-The Google Generative AI provider transforms Composio tools into a format compatible with [Gemini's function calling](https://ai.google.dev/) capabilities.
+Composio integrates with Google through [Gemini function calling](https://ai.google.dev/) and the [Agent Development Kit (ADK)](https://google.github.io/adk-docs/). Pick the tab that matches your integration.
+
+<IntegrationTabs tabs={[
+ { value: "gemini", label: "Gemini" },
+ { value: "adk", label: "ADK" },
+]}>
+
+<IntegrationContent value="gemini">
+
+The Google Generative AI provider transforms Composio tools into a format compatible with Gemini function calling.
<Steps>
<Step>
@@ -28,7 +37,7 @@ npm install @composio/core @composio/google @google/genai
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
</Callout>
```txt title=".env"
@@ -121,3 +130,84 @@ console.log(response.text);
</Tabs>
</Step>
</Steps>
+
+</IntegrationContent>
+
+<IntegrationContent value="adk">
+
+The Google ADK provider transforms Composio tools into Google ADK's FunctionTool format for use with Google ADK agents. ADK integration is Python-only.
+
+<Steps>
+<Step>
+**Install**
+
+```bash
+pip install composio composio_google_adk google-adk
+```
+</Step>
+
+<Step>
+**Configure API Keys**
+
+<Callout type="info">
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `GOOGLE_API_KEY` with your [Google API key](https://aistudio.google.com/apikey).
+</Callout>
+
+```txt title=".env"
+COMPOSIO_API_KEY=xxxxxxxxx
+GOOGLE_API_KEY=xxxxxxxxx
+```
+</Step>
+
+<Step>
+**Create session and run**
+
+```python
+from composio import Composio
+from composio_google_adk import GoogleAdkProvider
+from google.adk.agents import Agent
+from google.adk.runners import Runner
+from google.adk.sessions import InMemorySessionService
+from google.genai import types
+
+composio = Composio(provider=GoogleAdkProvider())
+
+# Create a session for your user
+session = composio.create(user_id="user_123")
+tools = session.tools()
+
+agent = Agent(
+ name="email_agent",
+ model="gemini-3-pro-preview",
+ instruction="You are an AI agent that sends emails using Gmail.",
+ tools=tools,
+)
+
+session_service = InMemorySessionService()
+adk_session = session_service.create_session_sync(
+ app_name="email_agent",
+ user_id="user_123",
+ session_id="session_1",
+)
+runner = Runner(
+ agent=agent,
+ app_name="email_agent",
+ session_service=session_service,
+)
+
+content = types.Content(
+ role="user",
+ parts=[types.Part(text="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")],
+)
+
+events = runner.run(user_id="user_123", session_id="session_1", new_message=content)
+for event in events:
+ if event.is_final_response() and event.content and event.content.parts:
+ print(event.content.parts[0].text)
+```
+</Step>
+</Steps>
+
+</IntegrationContent>
+
+</IntegrationTabs>
diff --git a/docs/content/docs/providers/index.mdx b/docs/content/docs/providers/index.mdx
index a33722415..5e41173f2 100644
--- a/docs/content/docs/providers/index.mdx
+++ b/docs/content/docs/providers/index.mdx
@@ -5,27 +5,23 @@ description: Composio works with any AI framework. Pick your preferred SDK to ge
Composio works with any AI framework. Each provider transforms Composio tools into the native format your framework expects — no glue code needed.
+## AI SDKs
+
+<ProviderGrid>
+ <ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
+ <ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
+ <ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />
+ <ProviderCard name="Google" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
+</ProviderGrid>
+
## Agent Frameworks
<ProviderGrid>
<ProviderCard name="LangChain" href="/docs/providers/langchain" logo="/images/providers/langchain-logo.svg" logoDark="/images/providers/langchain-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="LangGraph" href="/docs/providers/langgraph" logo="/images/providers/langgraph-logo.svg" languages={["Python"]} />
<ProviderCard name="CrewAI" href="/docs/providers/crewai" logo="/images/providers/crewai-logo.svg" languages={["Python"]} />
<ProviderCard name="LlamaIndex" href="/docs/providers/llamaindex" logo="/images/providers/llamaIndex-logo.svg" languages={["Python", "TypeScript"]} />
<ProviderCard name="Mastra" href="/docs/providers/mastra" logo="/images/providers/mastra-logo.svg" logoDark="/images/providers/mastra-logo-dark.svg" languages={["TypeScript"]} />
<ProviderCard name="AutoGen" href="/docs/providers/autogen" languages={["Python"]} />
- <ProviderCard name="Google ADK" href="/docs/providers/google-adk" logo="/images/providers/google-logo.svg" languages={["Python"]} />
-</ProviderGrid>
-
-## AI SDKs
-
-<ProviderGrid>
- <ProviderCard name="Claude Agent SDK" href="/docs/providers/claude-agent-sdk" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="Anthropic" href="/docs/providers/anthropic" logo="/images/providers/anthropic-logo.svg" logoDark="/images/providers/anthropic-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="OpenAI Agents" href="/docs/providers/openai-agents" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="OpenAI" href="/docs/providers/openai" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="Google Gemini" href="/docs/providers/google" logo="/images/providers/google-logo.svg" languages={["Python", "TypeScript"]} />
- <ProviderCard name="Vercel AI SDK" href="/docs/providers/vercel" logo="/images/providers/vercel-logo.svg" logoDark="/images/providers/vercel-logo-dark.svg" languages={["TypeScript"]} />
</ProviderGrid>
## Custom
diff --git a/docs/content/docs/providers/langchain.mdx b/docs/content/docs/providers/langchain.mdx
index 57995e033..ce14f3856 100644
--- a/docs/content/docs/providers/langchain.mdx
+++ b/docs/content/docs/providers/langchain.mdx
@@ -1,10 +1,19 @@
---
title: LangChain
-description: Build an agent with LangChain and enable it to use 1000+ tools with Composio.
-keywords: [langchain]
+description: Build an agent with LangChain or LangGraph and enable it to use 1000+ tools with Composio.
+keywords: [langchain, langgraph]
---
-The LangChain provider transforms Composio tools into LangChain's [StructuredTool](https://python.langchain.com/docs/how_to/custom_tools/) format with built-in execution.
+Composio integrates with [LangChain](https://python.langchain.com/) and [LangGraph](https://langchain-ai.github.io/langgraph/). Pick the tab that matches your integration.
+
+<IntegrationTabs tabs={[
+ { value: "langchain", label: "LangChain" },
+ { value: "langgraph", label: "LangGraph" },
+]}>
+
+<IntegrationContent value="langchain">
+
+The LangChain provider transforms Composio tools into LangChain's StructuredTool format with built-in execution.
<Steps>
<Step>
@@ -28,7 +37,7 @@ npm install @composio/core @composio/langchain @langchain/openai @langchain/lang
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
</Callout>
```txt title=".env"
@@ -116,3 +125,59 @@ console.log(finalState.messages[finalState.messages.length - 1].content);
</Tabs>
</Step>
</Steps>
+
+</IntegrationContent>
+
+<IntegrationContent value="langgraph">
+
+The LangGraph provider transforms Composio tools into LangChain StructuredTool format for use with LangGraph agents. LangGraph integration is Python-only.
+
+<Steps>
+<Step>
+**Install**
+
+```bash
+pip install composio composio_langgraph langgraph langchain_openai
+```
+</Step>
+
+<Step>
+**Configure API Keys**
+
+<Callout type="info">
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+</Callout>
+
+```txt title=".env"
+COMPOSIO_API_KEY=xxxxxxxxx
+OPENAI_API_KEY=xxxxxxxxx
+```
+</Step>
+
+<Step>
+**Create session and run**
+
+```python
+from composio import Composio
+from composio_langgraph import LanggraphProvider
+from langchain.agents import create_agent
+from langchain_openai import ChatOpenAI
+
+composio = Composio(provider=LanggraphProvider())
+llm = ChatOpenAI(model="gpt-5.2")
+
+# Create a session for your user
+session = composio.create(user_id="user_123")
+tools = session.tools()
+
+agent = create_agent(tools=tools, model=llm)
+result = agent.invoke({"messages": [("user", "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")]})
+
+print(result["messages"][-1].content)
+```
+</Step>
+</Steps>
+
+</IntegrationContent>
+
+</IntegrationTabs>
diff --git a/docs/content/docs/providers/langgraph.mdx b/docs/content/docs/providers/langgraph.mdx
deleted file mode 100644
index f0ccffec1..000000000
--- a/docs/content/docs/providers/langgraph.mdx
+++ /dev/null
@@ -1,53 +0,0 @@
----
-title: LangGraph
-description: Build an agent with LangGraph and enable it to use 1000+ tools with Composio.
-keywords: [langgraph]
----
-
-The LangGraph provider transforms Composio tools into LangChain's [StructuredTool](https://python.langchain.com/docs/how_to/custom_tools/) format for use with [LangGraph](https://langchain-ai.github.io/langgraph/) agents.
-
-<Steps>
-<Step>
-**Install**
-
-```bash
-pip install composio composio_langgraph langgraph langchain_openai
-```
-</Step>
-
-<Step>
-**Configure API Keys**
-
-<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
-</Callout>
-
-```txt title=".env"
-COMPOSIO_API_KEY=xxxxxxxxx
-OPENAI_API_KEY=xxxxxxxxx
-```
-</Step>
-
-<Step>
-**Create session and run**
-
-```python
-from composio import Composio
-from composio_langgraph import LanggraphProvider
-from langchain.agents import create_agent
-from langchain_openai import ChatOpenAI
-
-composio = Composio(provider=LanggraphProvider())
-llm = ChatOpenAI(model="gpt-5.2")
-
-# Create a session for your user
-session = composio.create(user_id="user_123")
-tools = session.tools()
-
-agent = create_agent(tools=tools, model=llm)
-result = agent.invoke({"messages": [("user", "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'")]})
-
-print(result["messages"][-1].content)
-```
-</Step>
-</Steps>
diff --git a/docs/content/docs/providers/llamaindex.mdx b/docs/content/docs/providers/llamaindex.mdx
index 49589a398..4fca3e410 100644
--- a/docs/content/docs/providers/llamaindex.mdx
+++ b/docs/content/docs/providers/llamaindex.mdx
@@ -28,7 +28,7 @@ npm install @composio/core @composio/llamaindex @llamaindex/openai @llamaindex/w
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
</Callout>
```txt title=".env"
diff --git a/docs/content/docs/providers/mastra.mdx b/docs/content/docs/providers/mastra.mdx
index 7156b60a3..c83d425a6 100644
--- a/docs/content/docs/providers/mastra.mdx
+++ b/docs/content/docs/providers/mastra.mdx
@@ -19,7 +19,7 @@ npm install @composio/core @composio/mastra @mastra/core @ai-sdk/openai
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
</Callout>
```txt title=".env"
diff --git a/docs/content/docs/providers/meta.json b/docs/content/docs/providers/meta.json
index 0871dc2c8..d83ada503 100644
--- a/docs/content/docs/providers/meta.json
+++ b/docs/content/docs/providers/meta.json
@@ -2,19 +2,15 @@
"title": "Providers",
"pages": [
"...",
- "claude-agent-sdk",
"anthropic",
- "openai-agents",
"openai",
- "autogen",
- "crewai",
+ "vercel",
"google",
- "google-adk",
"langchain",
- "langgraph",
+ "autogen",
+ "crewai",
"llamaindex",
"mastra",
- "vercel",
"custom-providers"
]
}
diff --git a/docs/content/docs/providers/openai-agents.mdx b/docs/content/docs/providers/openai-agents.mdx
deleted file mode 100644
index 1e92a3973..000000000
--- a/docs/content/docs/providers/openai-agents.mdx
+++ /dev/null
@@ -1,103 +0,0 @@
----
-title: OpenAI Agents SDK
-description: Build an agent with OpenAI Agents SDK and enable it to use 1000+ tools with Composio.
-keywords: [openai agents sdk, agents sdk]
----
-
-The OpenAI Agents SDK provider transforms Composio tools into the [Agents SDK tool format](https://openai.github.io/openai-agents-python/) with built-in execution.
-
-<Steps>
-<Step>
-**Install**
-
-<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
-<Tab value="Python">
-```bash
-pip install composio composio-openai-agents openai-agents
-```
-</Tab>
-<Tab value="TypeScript">
-```bash
-npm install @composio/core @composio/openai-agents @openai/agents
-```
-</Tab>
-</Tabs>
-</Step>
-
-<Step>
-**Configure API Keys**
-
-<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
-</Callout>
-
-```txt title=".env"
-COMPOSIO_API_KEY=xxxxxxxxx
-OPENAI_API_KEY=xxxxxxxxx
-```
-</Step>
-
-<Step>
-**Create session and run**
-
-<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
-<Tab value="Python">
-```python
-import asyncio
-from composio import Composio
-from composio_openai_agents import OpenAIAgentsProvider
-from agents import Agent, Runner
-
-composio = Composio(provider=OpenAIAgentsProvider())
-
-# Create a session for your user
-session = composio.create(user_id="user_123")
-tools = session.tools()
-
-agent = Agent(
- name="Email Agent",
- instructions="You are a helpful assistant.",
- tools=tools,
-)
-
-async def main():
- result = await Runner.run(
- starting_agent=agent,
- input="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",
- )
- print(result.final_output)
-
-asyncio.run(main())
-```
-</Tab>
-<Tab value="TypeScript">
-```typescript
-import { Composio } from "@composio/core";
-import { OpenAIAgentsProvider } from "@composio/openai-agents";
-import { Agent, run } from "@openai/agents";
-
-const composio = new Composio({
- provider: new OpenAIAgentsProvider(),
-});
-
-// Create a session for your user
-const session = await composio.create("user_123");
-const tools = await session.tools();
-
-const agent = new Agent({
- name: "Email Agent",
- instructions: "You are a helpful assistant.",
- tools,
-});
-
-const result = await run(
- agent,
- "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'"
-);
-
-console.log(result.finalOutput);
-```
-</Tab>
-</Tabs>
-</Step>
-</Steps>
diff --git a/docs/content/docs/providers/openai.mdx b/docs/content/docs/providers/openai.mdx
index 626c670ad..5f5601bd6 100644
--- a/docs/content/docs/providers/openai.mdx
+++ b/docs/content/docs/providers/openai.mdx
@@ -1,21 +1,21 @@
---
title: OpenAI
description: Build an agent with OpenAI and enable it to use 1000+ tools with Composio.
-keywords: [gpt, responses api, chat completions]
+keywords: [gpt, responses api, chat completions, openai agents sdk, agents sdk]
---
-The OpenAI Provider is the default provider for the Composio SDK. It transforms Composio tools into a format compatible with OpenAI's function calling capabilities through both the Responses and Chat Completion APIs.
-
-<Callout type="info">
-Looking for the OpenAI Agents SDK? See the [OpenAI Agents SDK](/docs/providers/openai-agents) provider page.
-</Callout>
+Composio integrates with OpenAI through the [Responses API](https://platform.openai.com/docs/api-reference/responses), [Chat Completions API](https://platform.openai.com/docs/api-reference/chat), and [Agents SDK](https://openai.github.io/openai-agents-python/). Pick the tab that matches your integration.
<IntegrationTabs tabs={[
{ value: "responses", label: "Responses API" },
{ value: "chat", label: "Chat Completions" },
+ { value: "agents", label: "Agents SDK" },
]}>
<IntegrationContent value="responses">
+
+The OpenAI Provider is the default provider for the Composio SDK. It transforms Composio tools into a format compatible with OpenAI function calling through the Responses API.
+
<Steps>
<Step>
**Install**
@@ -38,7 +38,7 @@ npm install @composio/core @composio/openai openai
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
</Callout>
```txt title=".env"
@@ -161,6 +161,9 @@ for (const item of response.output) {
</IntegrationContent>
<IntegrationContent value="chat">
+
+The `OpenAIProvider` (Chat Completions) is the default provider used by the Composio SDK when no other provider is specified.
+
<Steps>
<Step>
**Install**
@@ -183,7 +186,7 @@ npm install @composio/core @composio/openai openai
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
</Callout>
```txt title=".env"
@@ -296,6 +299,108 @@ console.log(response.choices[0].message.content);
</Steps>
</IntegrationContent>
+<IntegrationContent value="agents">
+
+The OpenAI Agents SDK provider transforms Composio tools into the Agents SDK tool format with built-in execution.
+
+<Steps>
+<Step>
+**Install**
+
+<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
+<Tab value="Python">
+```bash
+pip install composio composio-openai-agents openai-agents
+```
+</Tab>
+<Tab value="TypeScript">
+```bash
+npm install @composio/core @composio/openai-agents @openai/agents
+```
+</Tab>
+</Tabs>
+</Step>
+
+<Step>
+**Configure API Keys**
+
+<Callout type="info">
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `OPENAI_API_KEY` with your [OpenAI API key](https://platform.openai.com/api-keys).
+</Callout>
+
+```txt title=".env"
+COMPOSIO_API_KEY=xxxxxxxxx
+OPENAI_API_KEY=xxxxxxxxx
+```
+</Step>
+
+<Step>
+**Create session and run**
+
+<Tabs groupId="language" items={["Python", "TypeScript"]} persist>
+<Tab value="Python">
+```python
+import asyncio
+from composio import Composio
+from composio_openai_agents import OpenAIAgentsProvider
+from agents import Agent, Runner
+
+composio = Composio(provider=OpenAIAgentsProvider())
+
+# Create a session for your user
+session = composio.create(user_id="user_123")
+tools = session.tools()
+
+agent = Agent(
+ name="Email Agent",
+ instructions="You are a helpful assistant.",
+ tools=tools,
+)
+
+async def main():
+ result = await Runner.run(
+ starting_agent=agent,
+ input="Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'",
+ )
+ print(result.final_output)
+
+asyncio.run(main())
+```
+</Tab>
+<Tab value="TypeScript">
+```typescript
+import { Composio } from "@composio/core";
+import { OpenAIAgentsProvider } from "@composio/openai-agents";
+import { Agent, run } from "@openai/agents";
+
+const composio = new Composio({
+ provider: new OpenAIAgentsProvider(),
+});
+
+// Create a session for your user
+const session = await composio.create("user_123");
+const tools = await session.tools();
+
+const agent = new Agent({
+ name: "Email Agent",
+ instructions: "You are a helpful assistant.",
+ tools,
+});
+
+const result = await run(
+ agent,
+ "Send an email to [email protected] with the subject 'Hello' and body 'Hello from Composio!'"
+);
+
+console.log(result.finalOutput);
+```
+</Tab>
+</Tabs>
+</Step>
+</Steps>
+
+</IntegrationContent>
+
</IntegrationTabs>
## Multi-turn chat
diff --git a/docs/content/docs/providers/vercel.mdx b/docs/content/docs/providers/vercel.mdx
index dee1d6bbb..72bca1d97 100644
--- a/docs/content/docs/providers/vercel.mdx
+++ b/docs/content/docs/providers/vercel.mdx
@@ -19,7 +19,7 @@ npm install @composio/core @composio/vercel ai @ai-sdk/anthropic
**Configure API Keys**
<Callout type="info">
-Set `COMPOSIO_API_KEY` with your API key from [Settings](https://platform.composio.dev/?next_page=/settings) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
+Set `COMPOSIO_API_KEY` with your API key from [Settings](https://dashboard.composio.dev/~/project/settings/api-keys) and `ANTHROPIC_API_KEY` with your [Anthropic API key](https://console.anthropic.com/settings/keys).
</Callout>
```txt title=".env"
diff --git a/docs/content/docs/quickstart.mdx b/docs/content/docs/quickstart.mdx
index ced057fa4..467064d13 100644
--- a/docs/content/docs/quickstart.mdx
+++ b/docs/content/docs/quickstart.mdx
@@ -6,10 +6,6 @@ keywords: [tutorial, setup, first agent]
Build your first AI agent with Composio Tools. You'll create a [session](/docs/users-and-sessions) for a user, give your agent access to [tools](/docs/tools-and-toolkits), and let it take action across 1000+ apps.
-<Callout type="info">
-If you are an AI agent setting up Composio for yourself, you can [sign up as an agent](/docs/signing-up-as-an-agent) without a human-created account first.
-</Callout>
-
<QuickstartFlow>
<FrameworkOption id="openai-agents" name="OpenAI Agents" logo="/images/providers/openai-logo.svg" logoDark="/images/providers/openai-logo-dark.svg">
@@ -17,60 +13,6 @@ If you are an AI agent setting up Composio for yourself, you can [sign up as an
<IntegrationTabs>
<IntegrationContent value="native">
-<PromptBanner>
-**Add Composio tools to an OpenAI Agents app (Native Tools)**
-
-Give your OpenAI Agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio. Composio handles authentication, tool discovery, and execution. You create a **session** for a user, get tools from that session, and pass them to your Agent.
-
-**Key concepts**
-
-- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
-- **Provider**: Translates Composio tools into the framework's tool format. For OpenAI Agents, use `OpenAIAgentsProvider`.
-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
-
-**Rules**
-
-ALWAYS:
-- Initialize with `OpenAIAgentsProvider` as the provider
-- Create a session with a user ID before getting tools
-- Use `session.tools()` to get tools — this returns framework-ready tools
-- Store API keys in .env, load with dotenv
-
-NEVER:
-- Hardcode API keys in source code
-- Call tools directly without a session
-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
-
-**Deprecated (DO NOT use)**
-
-Python:
-```
-# WRONG — old direct execution pattern
-tools = composio.tools.get(user_id, { toolkits: ['github'] })
-result = composio.tools.execute('GITHUB_STAR_REPO', {...})
-
-# WRONG — old package name
-from composio_core import Composio
-```
-
-TypeScript:
-```
-// WRONG — old direct execution pattern
-const tools = composio.tools.get(userId, { toolkits: ['github'] });
-const result = composio.tools.execute('GITHUB_STAR_REPO', {...});
-```
-
-**Verify before responding**
-
-1. Is `OpenAIAgentsProvider` passed to `Composio()`?
-2. Is a session created with `composio.create(user_id)`?
-3. Are tools retrieved from `session.tools()`, not `composio.tools.get()`?
-4. Are API keys in .env, not hardcoded?
-5. Are imports from `composio` (Python) or `@composio/core` (TS)?
-
-</PromptBanner>
-
<Steps>
<Step>
<StepTitle>Install</StepTitle>
@@ -213,65 +155,6 @@ readline.close();
</IntegrationContent>
<IntegrationContent value="mcp">
-<PromptBanner>
-**Add Composio tools to an OpenAI Agents app (MCP)**
-
-Give your OpenAI Agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio's hosted MCP server. No provider package needed — you connect directly to Composio's MCP endpoint. Composio handles authentication, tool discovery, and execution. You create a **session** for a user and pass the MCP connection to your Agent.
-
-**Key concepts**
-
-- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
-- **MCP mode**: Instead of using a provider package, you connect to Composio's hosted MCP server using `session.mcp.url` and `session.mcp.headers`. No `@composio/openai-agents` package needed.
-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
-
-**Rules**
-
-ALWAYS:
-- Use `session.mcp.url` and `session.mcp.headers` from the session — these are unique per session
-- In Python, set `require_approval` to `"never"` in the tool_config
-- Create a session with a user ID before accessing `session.mcp`
-- Store API keys in .env, load with dotenv
-
-NEVER:
-- Hardcode MCP URLs or headers — they come from the session
-- Pass a provider to `Composio()` when using MCP mode (no provider needed)
-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
-
-**Deprecated (DO NOT use)**
-
-Python:
-```
-# WRONG — old direct execution pattern
-tools = composio.tools.get(user_id, { toolkits: ['github'] })
-result = composio.tools.execute('GITHUB_STAR_REPO', {...})
-
-# WRONG — using a provider with MCP (not needed)
-composio = Composio(provider=OpenAIAgentsProvider())
-
-# WRONG — old package name
-from composio_core import Composio
-```
-
-TypeScript:
-```
-// WRONG — old direct execution pattern
-const tools = composio.tools.get(userId, { toolkits: ['github'] });
-
-// WRONG — using a provider with MCP (not needed)
-const composio = new Composio({ provider: new OpenAIAgentsProvider() });
-```
-
-**Verify before responding**
-
-1. Is `Composio()` initialized WITHOUT a provider?
-2. Is a session created with `composio.create(user_id)`?
-3. Are `session.mcp.url` and `session.mcp.headers` used for the MCP connection?
-4. In Python, is `require_approval` set to `"never"`?
-5. Are API keys in .env, not hardcoded?
-
-</PromptBanner>
-
<Steps>
<Step>
<StepTitle>Install</StepTitle>
@@ -432,67 +315,6 @@ readline.close();
<IntegrationTabs>
<IntegrationContent value="native">
-<PromptBanner>
-**Add Composio tools to a Claude Agent SDK app (Native Tools)**
-
-Give your Claude agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio. Composio handles authentication, tool discovery, and execution. You create a **session** for a user, get tools, wrap them in an SDK MCP server, and pass that server to ClaudeAgentOptions.
-
-**Key concepts**
-
-- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
-- **Provider**: Translates Composio tools into the framework's tool format. For Claude Agent SDK, use `ClaudeAgentSDKProvider`.
-- **SDK MCP server**: Tools must be wrapped in an SDK MCP server via `create_sdk_mcp_server` / `createSdkMcpServer` before passing to `ClaudeAgentOptions.mcp_servers`. Do NOT pass tools directly.
-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
-
-**Rules**
-
-ALWAYS:
-- Initialize with `ClaudeAgentSDKProvider` as the provider
-- Create a session with a user ID before getting tools
-- Wrap tools in an SDK MCP server before passing to ClaudeAgentOptions
-- Use `async/await` — Claude Agent SDK is fully async
-- Store API keys in .env, load with dotenv
-
-NEVER:
-- Pass tools directly to ClaudeAgentOptions (must wrap in MCP server first)
-- Hardcode API keys in source code
-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
-
-**Deprecated (DO NOT use)**
-
-Python:
-```
-# WRONG — old direct execution pattern
-tools = composio.tools.get(user_id, { toolkits: ['github'] })
-result = composio.tools.execute('GITHUB_STAR_REPO', {...})
-
-# WRONG — passing tools directly without MCP server wrapper
-options = ClaudeAgentOptions(tools=tools)
-
-# WRONG — old package name
-from composio_core import Composio
-```
-
-TypeScript:
-```
-// WRONG — old direct execution pattern
-const tools = composio.tools.get(userId, { toolkits: ['github'] });
-
-// WRONG — passing tools directly without MCP server wrapper
-const options = new ClaudeAgentOptions({ tools });
-```
-
-**Verify before responding**
-
-1. Is `ClaudeAgentSDKProvider` passed to `Composio()`?
-2. Is a session created with `composio.create(user_id)`?
-3. Are tools wrapped in `create_sdk_mcp_server` / `createSdkMcpServer` before passing to options?
-4. Is the code using `async/await`?
-5. Are API keys in .env, not hardcoded?
-
-</PromptBanner>
-
<Steps>
<Step>
<StepTitle>Install</StepTitle>
@@ -659,67 +481,6 @@ readline.close();
</IntegrationContent>
<IntegrationContent value="mcp">
-<PromptBanner>
-**Add Composio tools to a Claude Agent SDK app (MCP)**
-
-Give your Claude agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio's hosted MCP server. No provider package needed — you connect directly to Composio's MCP endpoint. Composio handles authentication, tool discovery, and execution. You create a **session** for a user and pass the MCP connection to ClaudeAgentOptions.
-
-**Key concepts**
-
-- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
-- **MCP mode**: Instead of using a provider package, you connect to Composio's hosted MCP server using `session.mcp.url` and `session.mcp.headers`. No `@composio/claude-agent-sdk` package needed.
-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
-
-**Rules**
-
-ALWAYS:
-- Use `session.mcp.url` and `session.mcp.headers` from the session — these are unique per session
-- Set MCP server type to `"http"` in the mcp_servers config
-- In Python, set `permission_mode` to `"bypassPermissions"` in the mcp_servers config
-- Use `async/await` — Claude Agent SDK is fully async
-- Store API keys in .env, load with dotenv
-
-NEVER:
-- Hardcode MCP URLs or headers — they come from the session
-- Pass a provider to `Composio()` when using MCP mode (no provider needed)
-- Import from `composio-core` (the package is `composio` for Python, `@composio/core` for TS)
-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
-
-**Deprecated (DO NOT use)**
-
-Python:
-```
-# WRONG — old direct execution pattern
-tools = composio.tools.get(user_id, { toolkits: ['github'] })
-result = composio.tools.execute('GITHUB_STAR_REPO', {...})
-
-# WRONG — using a provider with MCP (not needed)
-composio = Composio(provider=ClaudeAgentSDKProvider())
-
-# WRONG — old package name
-from composio_core import Composio
-```
-
-TypeScript:
-```
-// WRONG — old direct execution pattern
-const tools = composio.tools.get(userId, { toolkits: ['github'] });
-
-// WRONG — using a provider with MCP (not needed)
-const composio = new Composio({ provider: new ClaudeAgentSDKProvider() });
-```
-
-**Verify before responding**
-
-1. Is `Composio()` initialized WITHOUT a provider?
-2. Is a session created with `composio.create(user_id)`?
-3. Are `session.mcp.url` and `session.mcp.headers` used in the `mcp_servers` config?
-4. Is the MCP server type set to `"http"`?
-5. Is the code using `async/await`?
-6. Are API keys in .env, not hardcoded?
-
-</PromptBanner>
-
<Steps>
<Step>
<StepTitle>Install</StepTitle>
@@ -903,56 +664,6 @@ readline.close();
<IntegrationTabs>
<IntegrationContent value="native">
-<PromptBanner>
-**Add Composio tools to a Vercel AI SDK app (Native Tools)**
-
-Give your Vercel AI agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio. Composio handles authentication, tool discovery, and execution. You create a **session** for a user, get tools from that session, and pass them to `streamText` or `generateText`. TypeScript only.
-
-**Key concepts**
-
-- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
-- **Provider**: Translates Composio tools into the framework's tool format. For Vercel AI, use `VercelProvider`.
-- **streamText vs generateText**: Use `streamText` for streaming responses, `generateText` for single responses. Both accept Composio tools via the `tools` parameter.
-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
-
-**Rules**
-
-ALWAYS:
-- Initialize with `VercelProvider` as the provider
-- Create a session with a user ID before getting tools
-- Use `session.tools()` to get tools — this returns Vercel AI-compatible tools
-- Use `streamText` or `generateText` from the `ai` package
-- Set `maxSteps` to allow multi-step tool use (e.g., `maxSteps: 10`)
-- Store API keys in .env, load with dotenv
-
-NEVER:
-- Hardcode API keys in source code
-- Call tools directly without a session
-- Import from `composio-core` (the package is `@composio/core`)
-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
-- Forget `maxSteps` — without it, the model won't execute tool calls
-
-**Deprecated (DO NOT use)**
-
-```
-// WRONG — old direct execution pattern
-const tools = composio.tools.get(userId, { toolkits: ['github'] });
-const result = composio.tools.execute('GITHUB_STAR_REPO', {...});
-
-// WRONG — missing maxSteps (model won't execute tool calls)
-const result = await generateText({ model, tools, prompt });
-```
-
-**Verify before responding**
-
-1. Is `VercelProvider` passed to `Composio()`?
-2. Is a session created with `composio.create(userId)`?
-3. Are tools retrieved from `session.tools()`, not `composio.tools.get()`?
-4. Is `maxSteps` set in `streamText` / `generateText`?
-5. Are API keys in .env, not hardcoded?
-
-</PromptBanner>
-
<Steps>
<Step>
<StepTitle>Install</StepTitle>
@@ -1047,60 +758,6 @@ readline.close();
</IntegrationContent>
<IntegrationContent value="mcp">
-<PromptBanner>
-**Add Composio tools to a Vercel AI SDK app (MCP)**
-
-Give your Vercel AI agent access to 1000+ tools (Gmail, GitHub, Slack, Notion, etc.) via Composio's hosted MCP server. No provider package needed — you connect directly to Composio's MCP endpoint using `@ai-sdk/mcp`. Composio handles authentication, tool discovery, and execution. TypeScript only.
-
-**Key concepts**
-
-- **Session**: Scoped environment for a user. Created with `composio.create(userId)`, reused with `composio.use(sessionId)`. Each `create()` returns a new session ID — store it and reuse for multi-turn conversations. Sessions have access to all toolkits by default.
-- **MCP mode**: Instead of using a provider package, you connect to Composio's hosted MCP server using `session.mcp.url` and `session.mcp.headers` via `@ai-sdk/mcp`. No `@composio/vercel` package needed.
-- **Client lifecycle**: Always close the MCP client with `await client.close()` when done.
-- **Authentication**: When a tool requires auth (e.g., GitHub OAuth), Composio returns an auth URL. The user authenticates once; Composio manages tokens.
-
-**Rules**
-
-ALWAYS:
-- Use `mcp.url` and `mcp.headers` from the session object returned by `composio.create(userId)`
-- Set transport type to `"http"` in createMCPClient
-- Set `maxSteps` to allow multi-step tool use (e.g., `maxSteps: 10`)
-- Close the MCP client when done: `await client.close()`
-- Store API keys in .env, load with dotenv
-
-NEVER:
-- Hardcode MCP URLs or headers — they come from the session
-- Pass a provider to `Composio()` when using MCP mode (no provider needed)
-- Import from `composio-core` (the package is `@composio/core`)
-- Use `composio.tools.get()` or `composio.tools.execute()` — these are deprecated direct execution patterns
-- Forget `maxSteps` — without it, the model won't execute tool calls
-- Forget `await client.close()` — this leaks the MCP connection
-
-**Deprecated (DO NOT use)**
-
-```
-// WRONG — old direct execution pattern
-const tools = composio.tools.get(userId, { toolkits: ['github'] });
-const result = composio.tools.execute('GITHUB_STAR_REPO', {...});
-
-// WRONG — using a provider with MCP (not needed)
-const composio = new Composio({ provider: new VercelProvider() });
-
-// WRONG — missing maxSteps (model won't execute tool calls)
-const result = await generateText({ model, tools, prompt });
-```
-
-**Verify before responding**
-
-1. Is `Composio()` initialized WITHOUT a provider?
-2. Are `mcp.url` and `mcp.headers` taken from the session returned by `composio.create(userId)`?
-3. Is transport type `"http"` in `createMCPClient`?
-4. Is `maxSteps` set in `streamText` / `generateText`?
-5. Is `client.close()` called when done?
-6. Are API keys in .env, not hardcoded?
-
-</PromptBanner>
-
<Steps>
<Step>
<StepTitle>Install</StepTitle>
@@ -1210,13 +867,7 @@ readline.close();
</QuickstartFlow>
-<Callout type="info">
-By default, sessions have access to **all available toolkits** in the Composio catalog. Your agent can discover and use any of them through `COMPOSIO_SEARCH_TOOLS`. To restrict which toolkits are available, see [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).
-</Callout>
-
-<Callout>
-Every `composio.create()` call returns a new session ID. For multi-turn conversations or web apps, store the session ID and call `composio.use(sessionId)` on subsequent requests instead of creating a new session each time. See [Reusing a session](/docs/users-and-sessions#reusing-a-session).
-</Callout>
+By default, each `composio.create()` call returns a new session with access to all toolkits. Sessions are highly configurable beyond that: [Reusing a session](/docs/users-and-sessions#reusing-a-session) covers storing a session ID and calling `composio.use()` across multi-turn requests, while [Configuring Sessions](/docs/configuring-sessions) covers restricting toolkits, auth configs, and connected accounts.
## Next steps
diff --git a/docs/content/docs/setting-up-triggers/creating-triggers.mdx b/docs/content/docs/setting-up-triggers/creating-triggers.mdx
index 875e4accc..c5f2608b6 100644
--- a/docs/content/docs/setting-up-triggers/creating-triggers.mdx
+++ b/docs/content/docs/setting-up-triggers/creating-triggers.mdx
@@ -235,7 +235,7 @@ Trigger instances default to the `'latest'` toolkit version. If your code parses
## Using the dashboard
-1. Navigate to [Auth Configs](https://platform.composio.dev?next_page=%2Fauth-configs) and select the auth config for the relevant toolkit
+1. Navigate to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) and select the auth config for the relevant toolkit
2. Navigate to **Active Triggers** and click **Create Trigger**
3. Select the connected account for which you want to create a trigger
4. Choose a trigger type and fill in the required configuration
diff --git a/docs/content/docs/setting-up-triggers/managing-triggers.mdx b/docs/content/docs/setting-up-triggers/managing-triggers.mdx
index 06057bca7..9bdfe646a 100644
--- a/docs/content/docs/setting-up-triggers/managing-triggers.mdx
+++ b/docs/content/docs/setting-up-triggers/managing-triggers.mdx
@@ -87,7 +87,7 @@ await composio.triggers.enable('ti_abcd123');
You can also toggle triggers from the dashboard:
-1. Go to [Auth Configs](https://platform.composio.dev?next_page=/auth-configs) and select your auth config
+1. Go to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) and select your auth config
2. Navigate to **Active Triggers**
3. Toggle the trigger on or off
diff --git a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
index 6dc91e3e5..0f9f66b9d 100644
--- a/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
+++ b/docs/content/docs/setting-up-triggers/subscribing-to-events.mdx
@@ -14,7 +14,7 @@ Webhooks are the recommended way to receive trigger events in production. To sta
| `composio.connected_account.expired` | Fired when a connected account expires and needs re-authentication. See [Subscribing to connection expiry events](/docs/subscribing-to-connection-expiry-events). |
| `composio.trigger.disabled` | **Fired when** Composio automatically disables a trigger — expired connection, webhook refresh failure, or unhealthy polling. **Not fired when** you disable a trigger through the manage API or deactivate its connected account via `PATCH /api/v3/connected_accounts/{id}/status`. |
-Set your webhook URL in the [dashboard settings](https://platform.composio.dev?next_page=/settings/webhook) or via the [Webhook Subscriptions API](/reference/api-reference/webhook-subscriptions):
+Set your webhook URL in the [dashboard settings](https://dashboard.composio.dev/~/project/settings/webhook) or via the [Webhook Subscriptions API](/reference/api-reference/webhook-subscriptions):
```bash
curl -X POST https://backend.composio.dev/api/v3.1/webhook_subscriptions \
diff --git a/docs/content/docs/single-toolkit-mcp.mdx b/docs/content/docs/single-toolkit-mcp.mdx
index df9a78813..4e79620a4 100644
--- a/docs/content/docs/single-toolkit-mcp.mdx
+++ b/docs/content/docs/single-toolkit-mcp.mdx
@@ -93,7 +93,7 @@ console.log(`Server created: ${server.id}`);
</Tabs>
<Callout type="info">
- You can also create and manage MCP configs from the [Composio dashboard](https://platform.composio.dev?next_page=/mcp-configs).
+ You can also create and manage MCP configs from the [Composio dashboard](https://dashboard.composio.dev/~/org/connect/clients).
</Callout>
</Step>
diff --git a/docs/content/docs/tools-direct/authenticating-tools.mdx b/docs/content/docs/tools-direct/authenticating-tools.mdx
index 4886ae752..d2c92e70b 100644
--- a/docs/content/docs/tools-direct/authenticating-tools.mdx
+++ b/docs/content/docs/tools-direct/authenticating-tools.mdx
@@ -25,7 +25,7 @@ An **Auth Config** is a blueprint that defines how authentication works for a to
<Step>
<StepTitle>Selecting a toolkit</StepTitle>
-Navigate to [Auth Configs](https://platform.composio.dev?next_page=%2Fauth-configs) tab in your dashboard and click "**Create Auth Config**". Find and select the toolkit you want to integrate (e.g., **Gmail**, **Slack**, **GitHub**).
+Navigate to [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) tab in your dashboard and click "**Create Auth Config**". Find and select the toolkit you want to integrate (e.g., **Gmail**, **Slack**, **GitHub**).
</Step>
<Step>
diff --git a/docs/content/docs/tools-direct/executing-tools.mdx b/docs/content/docs/tools-direct/executing-tools.mdx
index 7b8388064..59714f4da 100644
--- a/docs/content/docs/tools-direct/executing-tools.mdx
+++ b/docs/content/docs/tools-direct/executing-tools.mdx
@@ -190,7 +190,7 @@ If you just want to call a tool without using any framework or LLM provider, you
<Callout type="info">
**Finding tool parameters and types:**
-**Platform UI**: [Auth Configs](https://platform.composio.dev?next_page=/auth-configs) → Select your toolkit → Tools & Triggers → Select the tool to see its required and optional parameters
+**Platform UI**: [Auth Configs](https://dashboard.composio.dev/~/project/auth-configs) → Select your toolkit → Tools & Triggers → Select the tool to see its required and optional parameters
**CLI**: For Python and TypeScript projects, run `composio generate` to generate types. [Learn more →](/docs/cli#generate-type-definitions)
</Callout>
diff --git a/docs/content/docs/troubleshooting/index.mdx b/docs/content/docs/troubleshooting/index.mdx
index b6e3b1e40..a6ca698bd 100644
--- a/docs/content/docs/troubleshooting/index.mdx
+++ b/docs/content/docs/troubleshooting/index.mdx
@@ -12,7 +12,7 @@ This section is designed to help you quickly identify and resolve common issues
<Accordions>
<Accordion title="How do I find the log ID for a failed tool execution?">
-Every tool execution response includes a `log_id` field. You can also find it in the [dashboard logs](https://platform.composio.dev?next_page=/logs/tools) under **Logs > Tools**. Use this ID when reporting issues to support.
+Every tool execution response includes a `log_id` field. You can also find it in the [dashboard logs](https://dashboard.composio.dev/~/project/logs) under **Logs > Tools**. Use this ID when reporting issues to support.
See [Troubleshooting tools](/docs/troubleshooting/tools#reporting-tool-issues) for more details.
</Accordion>
diff --git a/docs/content/docs/troubleshooting/triggers.mdx b/docs/content/docs/troubleshooting/triggers.mdx
index 28f60003d..b77e5fc44 100644
--- a/docs/content/docs/troubleshooting/triggers.mdx
+++ b/docs/content/docs/troubleshooting/triggers.mdx
@@ -12,7 +12,7 @@ Check the error message — the connected account might not have sufficient perm
- **Polling triggers** (e.g., Gmail): These check for new events on an interval you configure. For Composio managed auth, intervals below 15 minutes are not supported.
- **Webhook URL**: Ensure your URL is publicly accessible and returns a `2xx` status code.
- **Trigger status**: Verify the trigger is enabled, not disabled.
-- **Logs**: Check the [trigger logs](https://platform.composio.dev?next_page=/logs/triggers) in the dashboard for delivery attempts and errors.
+- **Logs**: Check the [trigger logs](https://dashboard.composio.dev/~/project/logs?tab=triggers) in the dashboard for delivery attempts and errors.
## Type errors with trigger payloads
diff --git a/docs/content/docs/white-labeling-authentication.mdx b/docs/content/docs/white-labeling-authentication.mdx
index 9c8355a69..cc8edc8ec 100644
--- a/docs/content/docs/white-labeling-authentication.mdx
+++ b/docs/content/docs/white-labeling-authentication.mdx
@@ -21,7 +21,7 @@ The Connect Link is the hosted page your users see when connecting their account
To replace it with your own branding:
-1. Go to **Project Settings** → [**Auth Screen**](https://platform.composio.dev?next_page=/settings/auth-screen)
+1. Go to **Project Settings** → [**Auth Screen**](https://dashboard.composio.dev/~/project/settings/auth-screen)
2. Upload your **Logo** and set your **App Title**
This applies to all Connect Link flows across all toolkits, for both [in-chat](/docs/authenticating-users/in-chat-authentication) and [manual](/docs/authenticating-users/manually-authenticating) authentication. Each project has one logo and app title, so if you need different branding per product, use separate projects.
diff --git a/docs/content/toolkits/premium-tools.mdx b/docs/content/toolkits/premium-tools.mdx
index 776ae2652..4979f407a 100644
--- a/docs/content/toolkits/premium-tools.mdx
+++ b/docs/content/toolkits/premium-tools.mdx
@@ -1,36 +1,24 @@
---
title: Premium Tools
-description: Learn about premium tools, pricing, and limits in Composio
+description: Pricing and limits for premium tools in Composio
---
-This is a quick overview of premium tools, what they are, how they are priced, what limits they have and such.
+Some tool calls cost more to run — search APIs, code sandboxes, ML inference. We call those premium tools and price them separately.
-## What are premium tools?
+## What counts as a premium tool?
-Premium tools are essential tool calls that cost us more to run, normally paying for more premium services or longer running tasks.
+<Cards>
+ <Card icon={<Search />} title="Search APIs" href="/toolkits/composio_search" description="Composio Search, Perplexity, Exa, SerpAPI" />
+ <Card icon={<Code />} title="Code execution" href="/toolkits/codeinterpreter" description="Sandboxed runtimes like E2B" />
+ <Card icon={<Database />} title="Web scraping & data extraction" description="Crawlers and structured extraction" />
+ <Card icon={<Zap />} title="AI/ML inference" description="Hosted model calls and embeddings" />
+ <Card icon={<Wrench />} title="Document processing & OCR" description="PDF, image, and document parsing" />
+ <Card icon={<Rocket />} title="Compute-intensive operations" description="Long-running or heavy transforms" />
+</Cards>
-Think something like `E2B` or `Perplexity`, these are not really comparable to a `GMAIL_SEND_EMAIL` call.
+## Pricing
-These types of tools are separated out so we can price both of them competitively.
-
-Premium tools include:
-
-- Search APIs (Google, Bing, Perplexity, etc.)
- - [Composio Search](/toolkits/composio_search)
- - [Perplexity](/toolkits/perplexityai)
- - [Exa](/toolkits/exa)
- - [SerpAPI](/toolkits/serpapi)
-- Code execution environments (E2B)
- - [Code Interpreter (E2B)](/toolkits/codeinterpreter)
-- Web scraping & data extraction
-- AI/ML model inference
-- Document processing & OCR
-- Advanced data transformations
-- Compute-intensive operations
-
-## How are premium tools priced?
-
-As a rough guide, they are priced at 3x the cost of a standard tool call — the specifics depends on your plan and the tool.
+Premium tool calls are roughly 3x the cost of a standard tool call. Full pricing is on the [pricing page](https://composio.dev/pricing).
| Plan | Included Standard Tool Calls | Included Premium Tool Calls | Usage Based Standard Tool Calls | Usage Based Premium Tool Calls |
|------|------------------------------|-----------------------------|---------------------------------|--------------------------------|
@@ -39,22 +27,12 @@ As a rough guide, they are priced at 3x the cost of a standard tool call — the
| Serious Business | 2M | 50k | $0.249/1k | $0.747/1k |
| Enterprise | Flexible | Flexible | Flexible | Flexible |
-This is a quick call out — full pricing details are on the [pricing page](https://composio.dev/pricing).
-
-## What limits do premium tools have?
+## Rate limits
-Premium tools are also subject to lower rate limits than standard tool calls.
-
-If you need more than the default limits, please [contact us](mailto:[email protected]) and we can find a workable solution.
+Premium tools have lower rate limits than standard tool calls. If you need more, [contact us](mailto:[email protected]).
| Spending Tier | Standard Tool Calls Rate Limit | Premium Tool Calls Rate Limit |
|---------------|--------------------------------|-------------------------------|
| Free | 100/min | 1,000/hour |
| Paid | 5,000/min | 10,000/hour |
| Enterprise | Custom | Custom |
-
-## Feedback on premium tools
-
-These pricing changes are not rolling out immediately, and we are very open to feedback on the pricing and the limits.
-
-There is a lot of room for improvement and iteration here, please reach out if you have suggestions [here](mailto:[email protected]).
diff --git a/docs/lib/create-docs-page.tsx b/docs/lib/create-docs-page.tsx
index f91f33453..e7eb874c1 100644
--- a/docs/lib/create-docs-page.tsx
+++ b/docs/lib/create-docs-page.tsx
@@ -8,12 +8,13 @@ import { getMDXComponents } from '@/mdx-components';
import type { Metadata } from 'next';
import { createRelativeLink } from 'fumadocs-ui/mdx';
import { PageActions } from '@/components/page-actions';
+import { EditOnGitHub } from '@/components/edit-on-github';
import { getOgImageUrl } from '@/lib/source';
// eslint-disable-next-line @typescript-eslint/no-explicit-any
type Source = any;
-export function createDocsPage(source: Source) {
+export function createDocsPage(source: Source, contentDir: string = 'content/docs') {
return async function Page({ params }: { params: Promise<{ slug?: string[] }> }) {
const { slug } = await params;
const page = source.getPage(slug);
@@ -31,6 +32,7 @@ export function createDocsPage(source: Source) {
a: createRelativeLink(source, page),
})}
/>
+ <EditOnGitHub path={`docs/${contentDir}/${page.path}`} />
</DocsBody>
</DocsPage>
);
diff --git a/docs/lib/layout.shared.tsx b/docs/lib/layout.shared.tsx
index 19a549050..657f647f6 100644
--- a/docs/lib/layout.shared.tsx
+++ b/docs/lib/layout.shared.tsx
@@ -36,6 +36,7 @@ export function baseOptions(): BaseLayoutProps {
title: <ComposioLogo />,
transparentMode: 'top',
},
+ themeSwitch: { enabled: false },
searchToggle: {
components: {
lg: <SearchAndAskAI />,
@@ -84,7 +85,7 @@ export function baseOptions(): BaseLayoutProps {
Playground
</span>
),
- url: 'https://platform.composio.dev/auth?next_page=%2Ftool-router&utm_source=docs&utm_medium=navbar&utm_campaign=tool_router',
+ url: 'https://dashboard.composio.dev/~/project/playground?utm_source=docs&utm_medium=navbar&utm_campaign=playground',
external: true,
secondary: true,
},
diff --git a/docs/lib/source.ts b/docs/lib/source.ts
index 26ac2d3a3..08ce32ea1 100644
--- a/docs/lib/source.ts
+++ b/docs/lib/source.ts
@@ -213,8 +213,6 @@ export function mdxToCleanMarkdown(content: string): string {
(_, name, content) => `### ${name}\n\n${content.trim()}`
);
- result = result.replace(/<PromptBanner[\s\S]*?<\/PromptBanner>/g, '');
-
result = result.replace(
/<AIToolsBanner\s*\/>/g,
'### For AI tools\n\n' +
diff --git a/docs/mdx-components.tsx b/docs/mdx-components.tsx
index db0978fd3..7fad2012b 100644
--- a/docs/mdx-components.tsx
+++ b/docs/mdx-components.tsx
@@ -3,14 +3,14 @@ import type { MDXComponents } from 'mdx/types';
import type { ComponentProps } from 'react';
import { Accordion as BaseAccordion, Accordions } from 'fumadocs-ui/components/accordion';
import { Tabs, Tab, TabsList, TabsTrigger, TabsContent } from 'fumadocs-ui/components/tabs';
-import { Callout } from 'fumadocs-ui/components/callout';
+import { Callout } from '@/components/callout';
import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Card, Cards } from 'fumadocs-ui/components/card';
import { ImageZoom } from 'fumadocs-ui/components/image-zoom';
import { Heading } from '@/components/heading';
import { YouTube } from '@/components/youtube';
import { ProviderCard, ProviderGrid } from '@/components/provider-card';
-import { FrameworkSelector, QuickstartFlow, FrameworkOption, PromptBanner } from '@/components/quickstart';
+import { FrameworkSelector, QuickstartFlow, FrameworkOption } from '@/components/quickstart';
import { IntegrationTabs, IntegrationContent } from '@/components/quickstart/integration-tabs';
import { ToolTypeFlow, ToolTypeOption } from '@/components/tool-type-selector';
import { ConnectFlow, ConnectClientOption } from '@/components/connect-flow';
@@ -23,6 +23,7 @@ import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
import { ManagedAuthList } from '@/components/toolkits/managed-auth-list';
import { Mermaid } from '@/components/mermaid';
import { AIToolsBanner } from '@/components/ai-tools-banner';
+import { DocsHero } from '@/components/docs-hero';
import { Glossary, GlossaryTerm } from '@/components/glossary';
import { ApiBaseUrl } from '@/components/api-base-url';
import { ApiEndpointsTable } from '@/components/api-endpoints-table';
@@ -30,6 +31,7 @@ import {
ShieldCheck,
Route as RouteIcon,
Key,
+ Search,
Wrench,
Database,
Zap,
@@ -83,7 +85,6 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
FrameworkOption,
IntegrationTabs,
IntegrationContent,
- PromptBanner,
ToolTypeFlow,
ToolTypeOption,
ConnectFlow,
@@ -98,6 +99,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
ManagedAuthList,
Mermaid,
AIToolsBanner,
+ DocsHero,
StepTitle,
Glossary,
GlossaryTerm,
@@ -107,6 +109,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
ShieldCheck,
RouteIcon,
Key,
+ Search,
Wrench,
Database,
Zap,
diff --git a/docs/next.config.mjs b/docs/next.config.mjs
index ad347339a..7cea35ca3 100644
--- a/docs/next.config.mjs
+++ b/docs/next.config.mjs
@@ -156,6 +156,16 @@ const config = {
destination: '/docs/providers/google',
permanent: true,
},
+ {
+ source: '/providers/google-adk',
+ destination: '/docs/providers/google',
+ permanent: true,
+ },
+ {
+ source: '/docs/providers/google-adk',
+ destination: '/docs/providers/google',
+ permanent: true,
+ },
{
source: '/providers/langchain',
destination: '/docs/providers/langchain',
@@ -178,7 +188,32 @@ const config = {
},
{
source: '/providers/openai-agents',
- destination: '/docs/providers/openai-agents',
+ destination: '/docs/providers/openai',
+ permanent: true,
+ },
+ {
+ source: '/providers/claude-agent-sdk',
+ destination: '/docs/providers/anthropic',
+ permanent: true,
+ },
+ {
+ source: '/docs/providers/openai-agents',
+ destination: '/docs/providers/openai',
+ permanent: true,
+ },
+ {
+ source: '/docs/providers/claude-agent-sdk',
+ destination: '/docs/providers/anthropic',
+ permanent: true,
+ },
+ {
+ source: '/providers/langgraph',
+ destination: '/docs/providers/langchain',
+ permanent: true,
+ },
+ {
+ source: '/docs/providers/langgraph',
+ destination: '/docs/providers/langchain',
permanent: true,
},
{
diff --git a/docs/public/fonts/ABCDiatype-Medium.woff2 b/docs/public/fonts/ABCDiatype-Medium.woff2
new file mode 100644
index 000000000..3dbb9e02f
Binary files /dev/null and b/docs/public/fonts/ABCDiatype-Medium.woff2 differ
diff --git a/docs/public/fonts/ABCDiatype-Regular.woff2 b/docs/public/fonts/ABCDiatype-Regular.woff2
new file mode 100644
index 000000000..dc963475c
Binary files /dev/null and b/docs/public/fonts/ABCDiatype-Regular.woff2 differ
diff --git a/docs/public/fonts/ABCDiatype-RegularItalic.woff2 b/docs/public/fonts/ABCDiatype-RegularItalic.woff2
new file mode 100644
index 000000000..11eb88434
Binary files /dev/null and b/docs/public/fonts/ABCDiatype-RegularItalic.woff2 differ
diff --git a/docs/public/images/hero/managed-auth.png b/docs/public/images/hero/managed-auth.png
new file mode 100644
index 000000000..668cc6996
Binary files /dev/null and b/docs/public/images/hero/managed-auth.png differ
diff --git a/docs/public/images/hero/shader.jpg b/docs/public/images/hero/shader.jpg
new file mode 100644
index 000000000..9df690fce
Binary files /dev/null and b/docs/public/images/hero/shader.jpg differ
diff --git a/docs/public/images/hero/triggers.png b/docs/public/images/hero/triggers.png
new file mode 100644
index 000000000..38e469da2
Binary files /dev/null and b/docs/public/images/hero/triggers.png differ
diff --git a/docs/tests/integration/redirects.test.ts b/docs/tests/integration/redirects.test.ts
index f5498dda4..58cf19e6d 100644
--- a/docs/tests/integration/redirects.test.ts
+++ b/docs/tests/integration/redirects.test.ts
@@ -14,6 +14,13 @@ const REDIRECTS = [
{ from: "/api-reference", to: "/reference" },
{ from: "/providers/openai", to: "/docs/providers/openai" },
{ from: "/providers/anthropic", to: "/docs/providers/anthropic" },
+ { from: "/providers/openai-agents", to: "/docs/providers/openai" },
+ { from: "/docs/providers/openai-agents", to: "/docs/providers/openai" },
+ { from: "/docs/providers/claude-agent-sdk", to: "/docs/providers/anthropic" },
+ { from: "/providers/google-adk", to: "/docs/providers/google" },
+ { from: "/docs/providers/google-adk", to: "/docs/providers/google" },
+ { from: "/providers/langgraph", to: "/docs/providers/langchain" },
+ { from: "/docs/providers/langgraph", to: "/docs/providers/langchain" },
{ from: "/tools", to: "/toolkits" },
{ from: "/docs/fetching-tools", to: "/docs/tools-direct/fetching-tools" },
{ from: "/docs/custom-tools", to: "/docs/tools-direct/custom-tools" },
diff --git a/docs/tests/static/quickstart-prompts.test.ts b/docs/tests/static/quickstart-prompts.test.ts
deleted file mode 100644
index 8d755cab8..000000000
--- a/docs/tests/static/quickstart-prompts.test.ts
+++ /dev/null
@@ -1,115 +0,0 @@
-/**
- * Quickstart PromptBanner static validation.
- *
- * Validates prompt content quality directly from the MDX source:
- * - All 6 integration variants have prompts
- * - Each prompt has the required sections (concepts, rules, deprecated, verify)
- * - Prompts contain code examples (deprecated patterns)
- * - No markdown headings leak into TOC
- * - PromptBanner is stripped from LLM .md output
- */
-import { describe, test, expect } from "bun:test";
-import { readFile } from "fs/promises";
-import { join } from "path";
-import { mdxToCleanMarkdown } from "../../lib/source";
-
-const QUICKSTART_PATH = join(
- import.meta.dir,
- "../../content/docs/quickstart.mdx"
-);
-
-let rawContent: string;
-let blocks: string[];
-
-describe("Quickstart PromptBanner", () => {
- test("quickstart.mdx has 6 PromptBanner blocks (one per integration variant)", async () => {
- rawContent = await readFile(QUICKSTART_PATH, "utf-8");
- blocks =
- rawContent.match(/<PromptBanner>([\s\S]*?)<\/PromptBanner>/g) ?? [];
- expect(blocks.length).toBe(6);
- });
-
- test("each prompt has required sections", () => {
- const required = [
- "**Key concepts**",
- "**Rules**",
- "ALWAYS:",
- "NEVER:",
- "**Deprecated",
- "**Verify before responding**",
- ];
- const errors: string[] = [];
-
- for (let i = 0; i < blocks.length; i++) {
- for (const section of required) {
- if (!blocks[i].includes(section)) {
- errors.push(`Prompt #${i + 1}: missing "${section}"`);
- }
- }
- }
-
- expect(errors).toEqual([]);
- });
-
- test("each prompt has code in deprecated section", () => {
- const errors: string[] = [];
-
- for (let i = 0; i < blocks.length; i++) {
- const afterDeprecated = blocks[i].split("**Deprecated")[1] ?? "";
- const hasCodeFence = afterDeprecated.includes("```");
- if (!hasCodeFence) {
- errors.push(`Prompt #${i + 1}: deprecated section has no code examples`);
- }
- }
-
- expect(errors).toEqual([]);
- });
-
- test("each prompt mentions session-based pattern", () => {
- const errors: string[] = [];
-
- for (let i = 0; i < blocks.length; i++) {
- if (!blocks[i].includes("session") && !blocks[i].includes("Session")) {
- errors.push(`Prompt #${i + 1}: doesn't mention sessions`);
- }
- }
-
- expect(errors).toEqual([]);
- });
-
- test("each prompt warns against deprecated composio.tools.get()", () => {
- const errors: string[] = [];
-
- for (let i = 0; i < blocks.length; i++) {
- if (!blocks[i].includes("composio.tools.get()")) {
- errors.push(`Prompt #${i + 1}: missing composio.tools.get() deprecation warning`);
- }
- }
-
- expect(errors).toEqual([]);
- });
-
- test("no markdown headings inside prompts (would pollute TOC)", () => {
- const errors: string[] = [];
-
- for (let i = 0; i < blocks.length; i++) {
- const withoutCode = blocks[i].replace(/```[\s\S]*?```/g, "");
- const heading = withoutCode.match(/^#{1,6}\s+/m);
- if (heading) {
- errors.push(
- `Prompt #${i + 1}: contains heading "${heading[0].trim()}" — use **bold** instead`
- );
- }
- }
-
- expect(errors).toEqual([]);
- });
-
- test("mdxToCleanMarkdown strips all PromptBanner blocks from .md output", () => {
- const cleaned = mdxToCleanMarkdown(rawContent);
- expect(cleaned).not.toContain("<PromptBanner>");
- expect(cleaned).not.toContain("</PromptBanner>");
- expect(cleaned).not.toContain("ALWAYS:");
- expect(cleaned).not.toContain("Deprecated (DO NOT use)");
- });
-});