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 21, 13:30 UTC
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');