@devries-cameron20 / composio-1 / commits / a5f0b18b8
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.

docs: add KB start-here guide cards

Soham Basu committed Aug 28, 2026 at 18:34 UTC a5f0b18b8c77aaa4979c0e72ba93b222e708454f
2 files changed +69
docs/components/kb/knowledge-hub.tsx
+45
@@ -11,6 +11,33 @@ const popularToolkits = POPULAR_TOOLKIT_SLUGS.flatMap((slug) => {
11 const toolkit = toolkits.find((candidate) => candidate.slug === slug);
12 return toolkit ? [toolkit] : [];
13 });
14 +const START_HERE_GUIDES = [
15 + {
16 + title: 'Build your first agent',
17 + description: 'Create a session, connect an app, and run your first tool.',
18 + href: '/docs/quickstart',
19 + },
20 + {
21 + title: 'Use Composio with your coding agent',
22 + description: 'Let your coding agent help add, configure, or troubleshoot Composio.',
23 + href: '/docs/using-composio-skill',
24 + },
25 + {
26 + title: 'Build a consumer agent',
27 + description: 'Plan identity, connections, and sessions for individual users.',
28 + href: '/docs/consumer-agents',
29 + },
30 + {
31 + title: 'Build a B2B agent',
32 + description: 'Model tenants, members, and connection ownership for a multi-tenant product.',
33 + href: '/docs/b2b-agents',
34 + },
35 + {
36 + title: 'Move to production',
37 + description: 'Review authentication, security, reliability, and launch readiness.',
38 + href: '/docs/production-readiness',
39 + },
40 +];
41
42 export function KnowledgeHub() {
43 const browseAreas = PRODUCT_AREAS.filter((area) => area.defaultBrowse);
@@ -32,6 +59,24 @@ export function KnowledgeHub() {
59 </section>
60
61 <div className="mx-auto w-full max-w-7xl space-y-12 px-4 py-10 sm:px-6 sm:py-12 lg:px-8">
62 + <section id="start-here" aria-labelledby="start-here-title">
63 + <div>
64 + <h2 id="start-here-title" className="text-2xl font-semibold tracking-tight sm:text-3xl">Start here</h2>
65 + <p className="mt-2 text-sm leading-6 text-fd-muted-foreground">Choose the path that matches how you want to use Composio.</p>
66 + </div>
67 + <div className="mt-6 grid gap-px overflow-hidden border border-fd-border bg-fd-border sm:grid-cols-2 lg:grid-cols-5">
68 + {START_HERE_GUIDES.map((guide) => (
69 + <Link key={guide.href} href={guide.href} className="group bg-fd-background p-5 transition-colors hover:bg-fd-accent/50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-fd-ring">
70 + <h3 className="flex items-center justify-between gap-4 font-semibold">
71 + {guide.title}
72 + <ArrowRight className="size-4 shrink-0 text-fd-muted-foreground transition-transform group-hover:translate-x-1" aria-hidden="true" />
73 + </h3>
74 + <p className="mt-2 text-sm leading-6 text-fd-muted-foreground">{guide.description}</p>
75 + </Link>
76 + ))}
77 + </div>
78 + </section>
79 +
80 <section id="support-topics" aria-labelledby="support-topics-title">
81 <h2 id="support-topics-title" className="text-2xl font-semibold tracking-tight sm:text-3xl">Support topics</h2>
82 <div className="mt-6 grid gap-px overflow-hidden border border-fd-border bg-fd-border sm:grid-cols-2 lg:grid-cols-5">
docs/tests/static/knowledge-hub.test.tsx
+24
@@ -113,6 +113,30 @@ describe('knowledge hub', () => {
113 expect(discoverySections.every((section) => section.includes('href='))).toBe(true);
114 });
115
116 + test('presents the primary getting-started paths before support browsing', async () => {
117 + const html = renderToStaticMarkup(await KnowledgeHub());
118 + const startHere = html.match(
119 + /<section[^>]*aria-labelledby="start-here-title"[^>]*>[\s\S]*?<\/section>/,
120 + )?.[0];
121 +
122 + expect(startHere).toBeDefined();
123 + expect(startHere?.match(/href="[^"]+"/g)).toEqual([
124 + 'href="/docs/quickstart"',
125 + 'href="/docs/using-composio-skill"',
126 + 'href="/docs/consumer-agents"',
127 + 'href="/docs/b2b-agents"',
128 + 'href="/docs/production-readiness"',
129 + ]);
130 +
131 + const startHereIndex = html.indexOf('aria-labelledby="start-here-title"');
132 + const supportTopicsIndex = html.indexOf('aria-labelledby="support-topics-title"');
133 + const toolkitsIndex = html.indexOf('aria-labelledby="toolkits-title"');
134 +
135 + expect(startHereIndex).toBeGreaterThan(-1);
136 + expect(startHereIndex).toBeLessThan(supportTopicsIndex);
137 + expect(supportTopicsIndex).toBeLessThan(toolkitsIndex);
138 + });
139 +
140 test('builds a shareable search URL and exposes a screen-reader-only label', () => {
141 expect(getKnowledgeSearchHref('oauth github'))
142 .toBe('/kb/search?q=oauth+github');