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.

feat(docs): add PageActions and .md support to toolkit pages

Sushmithamallesh6a527e08e122
diff --git a/docs/app/(home)/toolkits/[[...slug]]/page.tsx b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
index 7619f4a2e..0e070a79a 100644
--- a/docs/app/(home)/toolkits/[[...slug]]/page.tsx
+++ b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
@@ -3,6 +3,7 @@ import { notFound } from 'next/navigation';
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 { readFile } from 'fs/promises';
import { join } from 'path';
import type { Metadata } from 'next';
@@ -101,6 +102,7 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?
const MDXContent = page.data.body;
return (
<article className="prose prose-fd max-w-none">
+ <PageActions path={page.url} />
<MDXContent components={getMDXComponents()} />
</article>
);
@@ -114,11 +116,14 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?
if (toolkit) {
return (
- <ToolkitDetail
- toolkit={toolkit}
- tools={toolkit.tools}
- triggers={toolkit.triggers}
- />
+ <>
+ <PageActions path={`/toolkits/${toolkit.slug}`} />
+ <ToolkitDetail
+ toolkit={toolkit}
+ tools={toolkit.tools}
+ triggers={toolkit.triggers}
+ />
+ </>
);
}
}
diff --git a/docs/app/llms.mdx/[[...slug]]/route.ts b/docs/app/llms.mdx/[[...slug]]/route.ts
index 1627d2ee4..3758ee85e 100644
--- a/docs/app/llms.mdx/[[...slug]]/route.ts
+++ b/docs/app/llms.mdx/[[...slug]]/route.ts
@@ -3,9 +3,13 @@ import {
toolRouterSource,
referenceSource,
examplesSource,
+ toolkitsSource,
getLLMText,
} from '@/lib/source';
import { notFound } from 'next/navigation';
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import type { Toolkit } from '@/types/toolkit';
export const revalidate = false;
@@ -15,8 +19,50 @@ const sources = [
{ prefix: 'tool-router', source: toolRouterSource },
{ prefix: 'reference', source: referenceSource },
{ prefix: 'examples', source: examplesSource },
+ { prefix: 'toolkits', source: toolkitsSource },
];
+// Generate markdown from toolkit JSON data
+function toolkitToMarkdown(toolkit: Toolkit): string {
+ const lines: string[] = [
+ `# ${toolkit.name.trim()}`,
+ '',
+ toolkit.description,
+ '',
+ `- **Category:** ${toolkit.category || 'Uncategorized'}`,
+ `- **Auth:** ${toolkit.authSchemes.join(', ') || 'None'}`,
+ `- **Tools:** ${toolkit.toolCount}`,
+ `- **Triggers:** ${toolkit.triggerCount}`,
+ ];
+
+ if (toolkit.tools.length > 0) {
+ lines.push('', '## Tools', '');
+ for (const tool of toolkit.tools) {
+ lines.push(`### ${tool.name}`, '', tool.description, '');
+ }
+ }
+
+ if (toolkit.triggers.length > 0) {
+ lines.push('', '## Triggers', '');
+ for (const trigger of toolkit.triggers) {
+ lines.push(`### ${trigger.name}`, '', trigger.description, '');
+ }
+ }
+
+ return lines.join('\n');
+}
+
+async function getToolkit(slug: string): Promise<Toolkit | null> {
+ try {
+ const filePath = join(process.cwd(), 'public/data/toolkits.json');
+ const data = await readFile(filePath, 'utf-8');
+ const toolkits = JSON.parse(data) as Toolkit[];
+ return toolkits.find((t) => t.slug === slug) || null;
+ } catch {
+ return null;
+ }
+}
+
export async function GET(
_req: Request,
{ params }: { params: Promise<{ slug?: string[] }> }
@@ -28,25 +74,39 @@ export async function GET(
const match = sources.find((s) => s.prefix === prefix);
if (!match) notFound();
- // Get the page from that source
+ // Get the page from that source (MDX pages)
const page = match.source.getPage(rest.length > 0 ? rest : undefined);
- if (!page) notFound();
- try {
- return new Response(await getLLMText(page), {
- headers: {
- 'Content-Type': 'text/markdown; charset=utf-8',
- },
- });
- } catch {
- // Graceful fallback
- return new Response(
- `# ${page.data.title} (${page.url})\n\n${page.data.description || ''}`,
- {
+ if (page) {
+ try {
+ return new Response(await getLLMText(page), {
+ headers: {
+ 'Content-Type': 'text/markdown; charset=utf-8',
+ },
+ });
+ } catch {
+ return new Response(
+ `# ${page.data.title} (${page.url})\n\n${page.data.description || ''}`,
+ {
+ headers: {
+ 'Content-Type': 'text/markdown; charset=utf-8',
+ },
+ }
+ );
+ }
+ }
+
+ // Special handling for JSON toolkit pages
+ if (prefix === 'toolkits' && rest.length === 1) {
+ const toolkit = await getToolkit(rest[0]);
+ if (toolkit) {
+ return new Response(toolkitToMarkdown(toolkit), {
headers: {
'Content-Type': 'text/markdown; charset=utf-8',
},
- }
- );
+ });
+ }
}
+
+ notFound();
}