@devries-cameron20 / composio Mirror · read-only / commits / 83f20d8de
Fork 0

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

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

Synced Nov 22, 10:45 UTC

docs: add FAQ section to toolkit detail pages

Add a per-toolkit FAQ system sourced from static markdown files in content/toolkit-faq/. FAQ content renders as accordions between the header and auth details sections. Markdown is converted to HTML at build time using remark/rehype. Also included in Copy Page markdown output via the LLM route. Includes initial FAQ content for 34 toolkits linking to auth setup guides, plus Monday.com-specific OAuth admin install instructions. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Sushmithamallesh committed Feb 9, 2026 at 12:46 UTC 83f20d8de18a21ced62b44b3cd3e8d52c8764b38
38 files changed +219 -7
docs/app/(home)/toolkits/[[...slug]]/page.tsx
+38 -2
@@ -6,8 +6,13 @@ import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
6 import { PageActions } from '@/components/page-actions';
7 import { readFile } from 'fs/promises';
8 import { join } from 'path';
9 +import { unified } from 'unified';
10 +import remarkParse from 'remark-parse';
11 +import remarkRehype from 'remark-rehype';
12 +import { toHtml } from 'hast-util-to-html';
13 import type { Metadata } from 'next';
14 import type { Toolkit, Tool, Trigger } from '@/types/toolkit';
15 +import type { FaqItem } from '@/components/toolkits/faq-section';
16 import { processSchema, toolFromApi } from '@/lib/toolkit-schema';
17
18 const API_BASE = process.env.COMPOSIO_API_BASE || 'https://backend.composio.dev/api/v3';
@@ -95,6 +100,35 @@ async function fetchDetailedTriggers(toolkitSlug: string, version?: string | nul
100 }
101 }
102
103 +function markdownToHtml(md: string): string {
104 + const tree = unified().use(remarkParse).parse(md);
105 + const hast = unified().use(remarkRehype).runSync(tree);
106 + return toHtml(hast);
107 +}
108 +
109 +async function readToolkitFaq(slug: string): Promise<FaqItem[] | null> {
110 + const filePath = join(process.cwd(), 'content/toolkit-faq', `${slug}.md`);
111 + let content: string;
112 + try {
113 + content = await readFile(filePath, 'utf-8');
114 + } catch {
115 + return null;
116 + }
117 +
118 + const items: FaqItem[] = [];
119 + const sections = content.split(/^## /m).filter(Boolean);
120 + for (const section of sections) {
121 + const newlineIdx = section.indexOf('\n');
122 + if (newlineIdx === -1) continue;
123 + const question = section.slice(0, newlineIdx).trim();
124 + const answerMd = section.slice(newlineIdx + 1).trim();
125 + if (question && answerMd) {
126 + items.push({ question, answer: markdownToHtml(answerMd) });
127 + }
128 + }
129 + return items.length > 0 ? items : null;
130 +}
131 +
132 async function getToolkits(): Promise<Toolkit[]> {
133 const filePath = join(process.cwd(), 'public/data/toolkits.json');
134
@@ -215,10 +249,11 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?
249 const toolkit = toolkits.find((t) => t.slug === toolkitSlug);
250
251 if (toolkit) {
218 - // Fetch detailed tool and trigger info from API (includes input/output params)
219 - const [detailedTools, detailedTriggers] = await Promise.all([
252 + // Fetch detailed tool/trigger info and FAQ content in parallel
253 + const [detailedTools, detailedTriggers, faq] = await Promise.all([
254 fetchDetailedTools(toolkitSlug, toolkit.version),
255 fetchDetailedTriggers(toolkitSlug, toolkit.version),
256 + readToolkitFaq(toolkitSlug),
257 ]);
258
259 // Use detailed data if fetch succeeded, otherwise fall back to static data
@@ -231,6 +266,7 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?
266 tools={tools}
267 triggers={triggers}
268 path={`/toolkits/${toolkit.slug}`}
269 + faq={faq}
270 />
271 );
272 }
docs/app/llms.mdx/[[...slug]]/route.ts
+21 -4
@@ -604,8 +604,18 @@ function renderParamsMarkdown(params: Record<string, ParameterSchema>): string[]
604 return lines;
605 }
606
607 +// Read FAQ markdown for a toolkit (returns raw markdown or null)
608 +async function readToolkitFaqMarkdown(slug: string): Promise<string | null> {
609 + try {
610 + const filePath = join(process.cwd(), 'content/toolkit-faq', `${slug}.md`);
611 + return await readFile(filePath, 'utf-8');
612 + } catch {
613 + return null;
614 + }
615 +}
616 +
617 // Generate markdown from toolkit with detailed tools and triggers
608 -function toolkitToMarkdown(toolkit: Toolkit, detailedTools?: Tool[], detailedTriggers?: Trigger[]): string {
618 +function toolkitToMarkdown(toolkit: Toolkit, detailedTools?: Tool[], detailedTriggers?: Trigger[], faqMarkdown?: string | null): string {
619 const tools = detailedTools || toolkit.tools;
620 const triggers = detailedTriggers || toolkit.triggers;
621
@@ -625,6 +635,11 @@ function toolkitToMarkdown(toolkit: Toolkit, detailedTools?: Tool[], detailedTri
635 lines.push(`- **Version:** ${toolkit.version}`);
636 }
637
638 + if (faqMarkdown && faqMarkdown.trim()) {
639 + lines.push('', '## Frequently Asked Questions', '');
640 + lines.push(faqMarkdown.trim());
641 + }
642 +
643 if (tools.length > 0) {
644 lines.push('', '## Tools', '');
645 for (const tool of tools) {
@@ -864,17 +879,19 @@ export async function GET(
879 if (prefix === 'toolkits' && rest.length === 1) {
880 const toolkit = await getToolkit(rest[0]);
881 if (toolkit) {
867 - // Fetch detailed tool and trigger info from API
868 - const [detailedTools, detailedTriggers] = await Promise.all([
882 + // Fetch detailed tool/trigger info and FAQ content in parallel
883 + const [detailedTools, detailedTriggers, faqMarkdown] = await Promise.all([
884 fetchDetailedTools(rest[0]),
885 fetchDetailedTriggers(rest[0]),
886 + readToolkitFaqMarkdown(rest[0]),
887 ]);
888
889 return new Response(
890 toolkitToMarkdown(
891 toolkit,
892 detailedTools !== null ? detailedTools : undefined,
877 - detailedTriggers !== null ? detailedTriggers : undefined
893 + detailedTriggers !== null ? detailedTriggers : undefined,
894 + faqMarkdown
895 ),
896 {
897 headers: {
docs/components/toolkits/faq-section.tsx new
+36
@@ -0,0 +1,36 @@
1 +'use client';
2 +
3 +import { HelpCircle } from 'lucide-react';
4 +import { Accordion, Accordions } from 'fumadocs-ui/components/accordion';
5 +
6 +export interface FaqItem {
7 + question: string;
8 + answer: string;
9 +}
10 +
11 +interface FaqSectionProps {
12 + faq: FaqItem[];
13 +}
14 +
15 +export function FaqSection({ faq }: FaqSectionProps) {
16 + if (!faq || faq.length === 0) return null;
17 +
18 + return (
19 + <div className="space-y-3">
20 + <h2 className="flex items-center gap-2 text-base font-semibold text-fd-foreground">
21 + <HelpCircle className="h-4 w-4" />
22 + Frequently Asked Questions
23 + </h2>
24 + <Accordions type="single">
25 + {faq.map((item) => (
26 + <Accordion key={item.question} title={item.question}>
27 + <div
28 + className="prose prose-sm prose-fd max-w-none text-fd-muted-foreground"
29 + dangerouslySetInnerHTML={{ __html: item.answer }}
30 + />
31 + </Accordion>
32 + ))}
33 + </Accordions>
34 + </div>
35 + );
36 +}
docs/components/toolkits/toolkit-detail.tsx
+6 -1
@@ -8,12 +8,14 @@ import type { Toolkit, Tool, Trigger, ParameterSchema } from '@/types/toolkit';
8 import { processSchema } from '@/lib/toolkit-schema';
9 import { PageActions } from '@/components/page-actions';
10 import { AuthDetailsSection } from '@/components/toolkits/auth-details-section';
11 +import { FaqSection, type FaqItem } from '@/components/toolkits/faq-section';
12
13 interface ToolkitDetailProps {
14 toolkit: Toolkit;
15 tools: Tool[];
16 triggers: Trigger[];
17 path: string;
18 + faq?: FaqItem[] | null;
19 }
20
21 function ToolkitIcon({ toolkit }: { toolkit: Toolkit }) {
@@ -239,7 +241,7 @@ function ToolItem({ item, toolkitVersion }: { item: Tool | Trigger; toolkitVersi
241 );
242 }
243
242 -export function ToolkitDetail({ toolkit, tools, triggers, path }: ToolkitDetailProps) {
244 +export function ToolkitDetail({ toolkit, tools, triggers, path, faq }: ToolkitDetailProps) {
245 const [copied, setCopied] = useState(false);
246 const [versionCopied, setVersionCopied] = useState(false);
247 const [toolSearch, setToolSearch] = useState('');
@@ -345,6 +347,9 @@ export function ToolkitDetail({ toolkit, tools, triggers, path }: ToolkitDetailP
347 </div>
348 </div>
349
350 + {/* FAQ */}
351 + {faq && faq.length > 0 && <FaqSection faq={faq} />}
352 +
353 {/* Authentication Details */}
354 {toolkit.authConfigDetails && toolkit.authConfigDetails.length > 0 && (
355 <AuthDetailsSection authConfigDetails={toolkit.authConfigDetails} />
docs/content/toolkit-faq/airtable.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Airtable?
2 +
3 +For a step-by-step guide on creating and configuring your own Airtable OAuth credentials with Composio, see [How to create OAuth credentials for Airtable](https://composio.dev/auth/airtable).
docs/content/toolkit-faq/asana.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Asana?
2 +
3 +For a step-by-step guide on creating and configuring your own Asana OAuth credentials with Composio, see [How to create OAuth credentials for Asana](https://composio.dev/auth/asana).
docs/content/toolkit-faq/canva.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Canva?
2 +
3 +For a step-by-step guide on creating and configuring your own Canva OAuth credentials with Composio, see [How to create OAuth credentials for Canva](https://composio.dev/auth/canva).
docs/content/toolkit-faq/confluence.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Confluence?
2 +
3 +For a step-by-step guide on creating and configuring your own Confluence OAuth credentials with Composio, see [How to create OAuth credentials for Confluence](https://composio.dev/auth/confluence).
docs/content/toolkit-faq/dropbox.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Dropbox?
2 +
3 +For a step-by-step guide on creating and configuring your own Dropbox OAuth credentials with Composio, see [How to create OAuth credentials for Dropbox](https://composio.dev/auth/dropbox).
docs/content/toolkit-faq/facebook.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Meta (Facebook)?
2 +
3 +For a step-by-step guide on creating and configuring your own Meta (Facebook) OAuth credentials with Composio, see [How to create OAuth credentials for Meta (Facebook)](https://composio.dev/auth/facebook).
docs/content/toolkit-faq/gitlab.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for GitLab?
2 +
3 +For a step-by-step guide on creating and configuring your own GitLab OAuth credentials with Composio, see [How to create OAuth credentials for GitLab](https://composio.dev/auth/gitlab).
docs/content/toolkit-faq/gmail.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Gmail?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/google_admin.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Admin?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/googlecalendar.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Calendar?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/googledocs.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Docs?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/googledrive.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Drive?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/googlemeet.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Meet?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/googlesheets.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Sheets?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/googleslides.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Slides?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/googletasks.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom Google OAuth credentials for Google Tasks?
2 +
3 +For a step-by-step guide on creating and configuring your own Google OAuth credentials with Composio, see [How to create OAuth2 credentials for Google Apps](https://composio.dev/auth/googleapps).
docs/content/toolkit-faq/hubspot.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for HubSpot?
2 +
3 +For a step-by-step guide on creating and configuring your own HubSpot OAuth credentials with Composio, see [How to create OAuth credentials for HubSpot](https://composio.dev/auth/hubspot).
docs/content/toolkit-faq/instantly.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Instantly?
2 +
3 +For a step-by-step guide on creating and configuring your own Instantly OAuth credentials with Composio, see [How to create OAuth credentials for Instantly](https://composio.dev/auth/instantly).
docs/content/toolkit-faq/jira.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Jira?
2 +
3 +For a step-by-step guide on creating and configuring your own Jira OAuth credentials with Composio, see [How to create OAuth credentials for Jira](https://composio.dev/auth/jira).
docs/content/toolkit-faq/linkedin.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for LinkedIn?
2 +
3 +For a step-by-step guide on creating and configuring your own LinkedIn OAuth credentials with Composio, see [How to create OAuth credentials for LinkedIn](https://composio.dev/auth/linkedin).
docs/content/toolkit-faq/monday.md new
+19
@@ -0,0 +1,19 @@
1 +## Why is Monday.com OAuth2 not working for my users?
2 +
3 +Monday.com requires a workspace admin to install the OAuth2 app before any user in that workspace can authorize their account. If the app is not installed, users will see an authorization error when trying to connect.
4 +
5 +## How do I install the Composio OAuth2 app for Monday.com?
6 +
7 +A workspace admin needs to visit the following URL and approve the app installation:
8 +
9 +`https://auth.monday.com/oauth2/authorize?client_id=96b038435fc029e045f9ba800e66fefa&response_type=install`
10 +
11 +Once the admin has installed the app, users in that workspace can authorize their accounts using OAuth2 as usual.
12 +
13 +## Do I need to install the app for each user?
14 +
15 +No. The admin only needs to install the app once per workspace. After that, any user in the workspace can connect their Monday.com account through Composio's OAuth2 flow.
16 +
17 +## How do I set up custom OAuth credentials for Monday.com?
18 +
19 +For a step-by-step guide on creating and configuring your own Monday.com OAuth credentials with Composio, see [How to create OAuth2 credentials for Monday](https://composio.dev/auth/monday).
docs/content/toolkit-faq/outlook.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Microsoft (Outlook)?
2 +
3 +For a step-by-step guide on creating and configuring your own Microsoft (Outlook) OAuth credentials with Composio, see [How to create OAuth credentials for Microsoft (Outlook)](https://composio.dev/auth/outlook).
docs/content/toolkit-faq/pipedrive.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Pipedrive?
2 +
3 +For a step-by-step guide on creating and configuring your own Pipedrive OAuth credentials with Composio, see [How to create OAuth credentials for Pipedrive](https://composio.dev/auth/pipedrive).
docs/content/toolkit-faq/posthog.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for PostHog?
2 +
3 +For a step-by-step guide on creating and configuring your own PostHog OAuth credentials with Composio, see [How to create OAuth credentials for PostHog](https://composio.dev/auth/posthog).
docs/content/toolkit-faq/salesforce.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Salesforce?
2 +
3 +For a step-by-step guide on creating and configuring your own Salesforce OAuth credentials with Composio, see [How to create OAuth credentials for Salesforce](https://composio.dev/auth/salesforce).
docs/content/toolkit-faq/shopify.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Shopify?
2 +
3 +For a step-by-step guide on creating and configuring your own Shopify OAuth credentials with Composio, see [How to create OAuth credentials for Shopify](https://composio.dev/auth/shopify).
docs/content/toolkit-faq/slack.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Slack?
2 +
3 +For a step-by-step guide on creating and configuring your own Slack OAuth credentials with Composio, see [How to create OAuth credentials for Slack](https://composio.dev/auth/slack).
docs/content/toolkit-faq/snowflake.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Snowflake?
2 +
3 +For a step-by-step guide on creating and configuring your own Snowflake OAuth credentials with Composio, see [How to create OAuth credentials for Snowflake](https://composio.dev/auth/snowflake).
docs/content/toolkit-faq/strava.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Strava?
2 +
3 +For a step-by-step guide on creating and configuring your own Strava OAuth credentials with Composio, see [How to create OAuth credentials for Strava](https://composio.dev/auth/strava).
docs/content/toolkit-faq/stripe.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Stripe?
2 +
3 +For a step-by-step guide on creating and configuring your own Stripe OAuth credentials with Composio, see [How to create OAuth credentials for Stripe](https://composio.dev/auth/stripe).
docs/content/toolkit-faq/xero.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Xero?
2 +
3 +For a step-by-step guide on creating and configuring your own Xero OAuth credentials with Composio, see [How to create OAuth credentials for Xero](https://composio.dev/auth/xero).
docs/content/toolkit-faq/zendesk.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Zendesk?
2 +
3 +For a step-by-step guide on creating and configuring your own Zendesk OAuth credentials with Composio, see [How to create OAuth credentials for Zendesk](https://composio.dev/auth/zendesk).
docs/content/toolkit-faq/zoho.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Zoho CRM?
2 +
3 +For a step-by-step guide on creating and configuring your own Zoho CRM OAuth credentials with Composio, see [How to create OAuth credentials for Zoho CRM](https://composio.dev/auth/zoho).
docs/content/toolkit-faq/zoom.md new
+3
@@ -0,0 +1,3 @@
1 +## How do I set up custom OAuth credentials for Zoom?
2 +
3 +For a step-by-step guide on creating and configuring your own Zoom OAuth credentials with Composio, see [How to create OAuth credentials for Zoom](https://composio.dev/auth/zoom).