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, 13:15 UTC
docs: improve authentication page with video and card styling
- Add connect link auth flow video recording - Add BookOpen icon for guide cards - Style cards with subtle gray background and orange hover border - Add Next steps section with related guide cards - Update users-and-sessions with BookOpen icons Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh committed
Jan 26, 2026 at 00:59 UTC
50efae7a74ae73be2599f2f8c83ab91c761a2387
5 files changed
+49
-40
docs/app/global.css
+6
-2
@@ -328,8 +328,12 @@ textarea:focus-visible {
328
outline: none;
329
}
330
331
-[data-card]:hover {
332
- border-color: color-mix(in srgb, var(--composio-orange) 50%, transparent);
331
+[data-card="true"] {
332
+ background: var(--color-fd-muted);
333
+}
334
+
335
+[data-card="true"]:hover {
336
+ border-color: var(--composio-orange);
337
}
338
339
[data-fumadocs-tabs] [data-state="active"] {
docs/content/docs/authentication.mdx
+37
-36
@@ -4,7 +4,9 @@ description: Understand how Tool Router handles user authentication to toolkits
4
keywords: [connect link, oauth]
5
---
6
7
-Tool Router handles authentication through [Connect Links](/docs/authenticating-tools#hosted-authentication-connect-link), hosted pages where users complete OAuth or enter credentials.
7
+Tool Router handles authentication through Connect Links, hosted pages where users complete OAuth or enter credentials.
8
+
9
+<video src="/images/connect-link-auth-flow-recording.mp4" autoPlay loop muted playsInline className="rounded-lg border" />
10
11
## In-chat authentication
12
@@ -12,45 +14,27 @@ By default, when a tool requires authentication, the agent prompts the user with
14
15
Here's what this looks like in a conversation:
16
15
-```
16
-You: Star the composio repo on GitHub
17
-
18
-Agent: I need you to connect your GitHub account first.
19
- Please click here to authorize: https://connect.composio.dev/link/ln_abc123
17
+> **You:** Summarize my emails from today
18
+>
19
+> **Agent:** I need you to connect your Gmail account first. Please click here to authorize: https://connect.composio.dev/link/ln_abc123
20
+>
21
+> **You:** Done
22
+>
23
+> **Agent:** Here's a summary of your emails from today...
24
21
-You: Done
25
+This flow works well for chat applications where users interact directly with the agent.
26
23
-Agent: Done! I've starred ComposioHQ/composio.
24
-```
25
-
26
-This flow works well for chat applications where users interact directly with the agent. See [In-chat authentication](/docs/authenticating-users/in-chat-authentication).
27
+<Card icon={<BookOpen />} title="In-chat authentication" href="/docs/authenticating-users/in-chat-authentication">
28
+ Let the agent handle authentication prompts automatically during conversation
29
+</Card>
30
31
## Manual authentication
32
30
-For apps that manage auth outside of chat, use `session.authorize()` to generate Connect Links programmatically:
31
-
32
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
33
-<Tab value="Python">
34
-```python
35
-connection_request = session.authorize("github")
36
-print(connection_request.redirect_url)
37
-# https://connect.composio.dev/link/ln_abc123
38
-```
39
-</Tab>
40
-<Tab value="TypeScript">
41
-```typescript
42
-import { Composio } from '@composio/core';
43
-const composio = new Composio({ apiKey: 'your_api_key' });
44
-const session = await composio.toolRouter.create('user_123', { toolkits: ['github'] });
45
-// ---cut---
46
-const connectionRequest = await session.authorize("github");
47
-console.log(connectionRequest.redirectUrl);
48
-// https://connect.composio.dev/link/ln_abc123
49
-```
50
-</Tab>
51
-</Tabs>
52
-
53
-Use this when you want users to connect accounts during onboarding, or when building a custom connections page. See [Manually authenticating users](/docs/authenticating-users/manually-authenticating) for a detailed guide.
33
+For apps that manage auth outside of chat, use `session.authorize()` to generate Connect Links programmatically. This is useful when you want users to connect accounts during onboarding, or when building a custom connections page.
34
+
35
+<Card icon={<BookOpen />} title="Manual authentication" href="/docs/authenticating-users/manually-authenticating">
36
+ Generate Connect Links and manage authentication flows in your application
37
+</Card>
38
39
## How Tool Router manages auth configs
40
@@ -72,4 +56,21 @@ Toolkits without Composio managed auth require a custom auth config. See [Using
56
57
## White-labeling
58
75
-Show your own branding on OAuth consent screens by creating your own OAuth app. See [White-labeling authentication](/docs/guides/white-labeling-authentication).
59
+Show your own branding on OAuth consent screens by creating your own OAuth app.
60
+
61
+## Next steps
62
+
63
+<Cards>
64
+ <Card title="In-chat authentication" href="/docs/authenticating-users/in-chat-authentication">
65
+ Let the agent prompt users to authenticate during conversation
66
+ </Card>
67
+ <Card title="Manual authentication" href="/docs/authenticating-users/manually-authenticating">
68
+ Generate Connect Links programmatically in your app
69
+ </Card>
70
+ <Card title="White-labeling" href="/docs/white-labeling-authentication">
71
+ Customize OAuth screens with your branding
72
+ </Card>
73
+ <Card title="Custom auth configs" href="/docs/using-custom-auth-configuration">
74
+ Use your own OAuth apps with Tool Router
75
+ </Card>
76
+</Cards>
docs/content/docs/users-and-sessions.mdx
+2
-2
@@ -24,7 +24,7 @@ Let's say you want to allow users to connect both their work and personal email.
24
account ID.
25
26
Here is a detailed guide on how to manage such connections:
27
-<Card title="Managing Multiple Connections" href="/docs/managing-multiple-connected-accounts" description="Handle multiple accounts per toolkit for a single user" />
27
+<Card icon={<BookOpen />} title="Managing Multiple Connections" href="/docs/managing-multiple-connected-accounts" description="Handle multiple accounts per toolkit for a single user" />
28
29
30
## Sessions
@@ -96,4 +96,4 @@ const toolkits = await session.toolkits();
96
97
For details on enabling toolkits, setting auth configs, and using session methods:
98
99
-<Card title="Configuring Sessions" href="/docs/configuring-sessions" description="Enable toolkits, set auth configs, and select connected accounts" />
99
+<Card icon={<BookOpen />} title="Configuring Sessions" href="/docs/configuring-sessions" description="Enable toolkits, set auth configs, and select connected accounts" />
docs/mdx-components.tsx
+4
@@ -14,6 +14,7 @@ import { ToolTypeFlow, ToolTypeOption } from '@/components/tool-type-selector';
14
import { Figure } from '@/components/figure';
15
import { Video } from '@/components/video';
16
import { CapabilityCard, CapabilityList } from '@/components/capability-card';
17
+import { GuideLink } from '@/components/guide-link';
18
import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
19
import { ShieldCheck, Route as RouteIcon } from 'lucide-react';
20
import {
@@ -28,6 +29,7 @@ import {
29
Play,
30
Terminal,
31
Palette,
32
+ BookOpen,
33
} from 'lucide-react';
34
35
export function getMDXComponents(components?: MDXComponents): MDXComponents {
@@ -60,6 +62,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
62
Video,
63
CapabilityCard,
64
CapabilityList,
65
+ GuideLink,
66
ToolkitsLanding,
67
// Lucide icons - available globally in MDX without imports
68
ShieldCheck,
@@ -75,6 +78,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
78
Play,
79
Terminal,
80
Palette,
81
+ BookOpen,
82
...components,
83
};
84
}
docs/public/images/connect-link-auth-flow-recording.mp4
Binary files /dev/null and b/docs/public/images/connect-link-auth-flow-recording.mp4 differ