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.

docs: reorganize meta files

Sushmithamallesh02a0dd96a983
diff --git a/fumadocs/.claude/decisions/examples.md b/fumadocs/.claude/decisions/examples.md
new file mode 100644
index 000000000..b0d7b8e00
--- /dev/null
+++ b/fumadocs/.claude/decisions/examples.md
@@ -0,0 +1,134 @@
+# Examples Page Plan
+
+Based on user interview analysis from #user-interviews Slack channel (50 use cases extracted).
+
+## Structure
+
+### Getting started
+| Example | What it demonstrates |
+|---------|---------------------|
+| Hello, world | First tool execution, basic setup |
+| Connect your first app in 60 seconds | OAuth flow, connected accounts |
+
+### Guides
+| Example | What it demonstrates |
+|---------|---------------------|
+| Building a Chat Agent | Core agentic loop, conversation context |
+| Building a RAG Agent | Tool router + knowledge retrieval |
+| Building a Slackbot Agent | Real-time messaging, event handling |
+| Building a Natural Language Data Analysis Agent | Complex queries, structured output |
+| Get started with Claude Code | MCP setup, Claude integration |
+| Get started with OpenAI Agents SDK | Native tools with OpenAI |
+| Get started with Vercel AI SDK | Streaming, Next.js integration |
+| Get started with LangChain | LangChain tools wrapper |
+| Get started with Mastra | Mastra framework integration |
+| Get started with CrewAI | Multi-agent with CrewAI |
+
+### Agents
+| Example | What it demonstrates |
+|---------|---------------------|
+| Build a PR review agent with GitHub and Claude | Multi-tool (GitHub + AI), code context |
+| Deploy an email assistant that drafts responses | Email integration, response generation |
+| Create a Slack bot with access to 250+ tools | Tool router, many toolkits |
+| Run a research agent that searches, scrapes, and summarizes | Web tools, chaining outputs |
+| Build an AI SDR that enriches leads automatically | CRM + web research, data enrichment |
+| Build an agentic RAG agent over your docs | RAG + tool calling combined |
+| Build a data analysis agent with natural language queries | Database tools, natural language to SQL |
+| Build a voice agent with real-time tool calling | Voice + tools, real-time streaming |
+| Spawn sub-agents for parallel task execution | Sub-agents, parallel processing |
+| Orchestrate multiple agents on a complex workflow | Multi-agent coordination, handoffs |
+| SEO data retrieval agent | Specialized data APIs, reporting |
+
+### Code & DevOps
+| Example | What it demonstrates |
+|---------|---------------------|
+| Auto-triage GitHub issues and assign owners | GitHub API, classification, automation |
+| Sync Linear tickets to Slack on status change | Cross-tool sync, webhooks |
+| Post CI failure summaries to Discord | CI integration, notifications |
+| Create Jira tickets from Slack messages | Slack → Jira, message parsing |
+
+### Communication & Social
+| Example | What it demonstrates |
+|---------|---------------------|
+| Send personalized emails at scale with Gmail | Bulk operations, personalization |
+| Build a Discord bot that manages your server | Discord API, bot commands |
+| Auto-respond to Slack DMs with context | Slack events, contextual responses |
+| LinkedIn content strategy agent | LinkedIn API, content generation |
+
+### Sales & CRM
+| Example | What it demonstrates |
+|---------|---------------------|
+| HubSpot CRM automation: new lead → research → enrich | CRM integration, data enrichment pipeline |
+
+### Productivity & Data
+| Example | What it demonstrates |
+|---------|---------------------|
+| Sync databases to Google Sheets automatically | Database + Sheets, data sync |
+| Build a meeting notes → Notion pipeline | Transcription + Notion, structured data |
+| Create calendar events from natural language | NLP input, calendar APIs |
+| Download attachments and process them | File download, file processing |
+| Turn documents into structured output | Document parsing, structured extraction |
+| Shopify sales reporting to Slack | E-commerce data, scheduled reports |
+
+### Triggers & Background jobs
+| Example | What it demonstrates |
+|---------|---------------------|
+| Build a Shopify customer support agent | E-commerce + support, always-on agent |
+| Run an agent when new emails arrive | Email triggers, event-driven |
+| Auto-review PRs on push | GitHub webhooks, automated review |
+| Daily digest: Summarize GitHub activity to Slack | Scheduled jobs, aggregation |
+| Weekly business report automation | Cron-style scheduling, multi-source data |
+| Webhook → process → route to the right tool | Generic webhooks, routing logic |
+
+---
+
+## Summary
+
+**Total: ~45 examples** across 8 categories
+
+## Design Notes
+
+- Style inspired by [Modal examples](https://modal.com/docs/examples) (domain categories, action-oriented naming)
+- "Get started with..." section inspired by [Vercel AI SDK cookbook](https://ai-sdk.dev/cookbook)
+- Framework (AI SDK, LangChain, etc.) shown as tabs within examples, not as primary categories
+- Advanced features (file upload/download, sub-agents) embedded in real use cases, not separate sections
+
+## Data Source
+
+- Google Sheet with all 50 use cases: https://docs.google.com/spreadsheets/d/16AH6LQyS5SZh2IezvwJptEGjR-LwLt0YfLEvtfqq94o/edit
+- Extracted from Slack #user-interviews channel (157 messages, 77 substantial)
+
+---
+
+## Future Plans
+
+### Featured Section
+- Add a hero grid at the top with 5 "wow" examples prominently displayed
+- Similar to Modal's featured examples
+
+### Templates
+- Pre-built starters users can clone
+- "AI Email Assistant Template"
+- "GitHub Bot Template"
+- "Slack Bot Template"
+
+### More Sales & CRM Examples
+- Salesforce automation
+- Deal tracking agent
+- Pipeline management agent
+
+### MCP-Specific Section
+- Connect Composio MCP to Claude Desktop
+- Use Composio MCP with Cursor
+- MCP setup with other clients
+- (This is a big entry point for users)
+
+### File Handling Example
+- Process uploaded PDFs and summarize them
+- Download attachments and analyze them
+- (Users mentioned this frequently in interviews)
+
+### Additional Examples to Match Modal Quality
+- Need ~20 more examples total
+- More specific, action-oriented naming
+- Cover edge cases and advanced patterns
diff --git a/fumadocs/.claude/TOOLKITS_PLAN.md b/fumadocs/.claude/decisions/toolkits.md
similarity index 100%
rename from fumadocs/.claude/TOOLKITS_PLAN.md
rename to fumadocs/.claude/decisions/toolkits.md
diff --git a/fumadocs/CONTRIBUTING.md b/fumadocs/CONTRIBUTING.md
deleted file mode 100644
index 0fe6fd11b..000000000
--- a/fumadocs/CONTRIBUTING.md
+++ /dev/null
@@ -1,114 +0,0 @@
-# Contributing to Composio Docs
-
-## Prerequisites
-
-- [Bun](https://bun.sh/) (v1.0+)
-- Node.js 18+
-
-## Getting Started
-
-### 1. Install dependencies
-
-```bash
-bun install
-```
-
-### 2. Run the dev server
-
-```bash
-bun run dev
-```
-
-The docs will be available at [http://localhost:3000](http://localhost:3000).
-
-### 3. Build for production
-
-```bash
-bun run build
-```
-
-## Project Structure
-
-```
-fumadocs/
-├── app/ # Next.js app router pages
-│ └── (home)/ # Main docs routes
-│ ├── docs/ # /docs section
-│ ├── tool-router/ # /tool-router section
-│ ├── examples/ # /examples section
-│ └── ...
-├── content/ # MDX content files
-│ ├── docs/ # Docs pages
-│ ├── tool-router/ # Tool Router pages
-│ ├── examples/ # Examples pages
-│ └── ...
-├── components/ # React components
-├── lib/ # Utilities and source config
-└── public/ # Static assets
-```
-
-## Adding/Editing Content
-
-### Adding a new page
-
-1. Create a new `.mdx` file in the appropriate `content/` folder
-2. Add frontmatter with `title` and `description`
-3. Add the page to the folder's `meta.json`
-
-Example:
-
-```mdx
----
-title: My New Page
-description: A brief description
----
-
-Your content here...
-```
-
-### Using components
-
-Common components available in MDX:
-
-```mdx
-<Tabs items={['Python', 'TypeScript']}>
- <Tab value="Python">Python code here</Tab>
- <Tab value="TypeScript">TypeScript code here</Tab>
-</Tabs>
-
-<Callout type="info">Important information</Callout>
-
-<Steps>
- <Step>### Step 1</Step>
- <Step>### Step 2</Step>
-</Steps>
-
-<Cards>
- <Card title="Title" href="/path" />
-</Cards>
-```
-
-## Sidebar Configuration
-
-Each content folder has a `meta.json` that controls sidebar order:
-
-```json
-{
- "title": "Section Title",
- "pages": [
- "---Section Header---",
- "page-one",
- "page-two",
- "nested-folder"
- ]
-}
-```
-
-## Common Commands
-
-| Command | Description |
-|---------|-------------|
-| `bun run dev` | Start dev server |
-| `bun run build` | Production build |
-| `bun run start` | Start production server |
-| `bun run types:check` | Type check |
diff --git a/fumadocs/README.md b/fumadocs/README.md
index f0881be34..45fbf45e1 100644
--- a/fumadocs/README.md
+++ b/fumadocs/README.md
@@ -1,126 +1,73 @@
# Composio Docs
-The official documentation site for Composio.
-
-## Tech Stack
-
-- **Framework**: [Next.js 16](https://nextjs.org/) (App Router)
-- **React**: React 19
-- **Documentation**: [Fumadocs](https://fumadocs.dev/)
-- **Content**: MDX (Markdown + JSX)
-- **Styling**: [Tailwind CSS v4](https://tailwindcss.com/)
-- **Language**: TypeScript 5.9
-- **Package Manager**: Bun
+Documentation site for Composio, built with [Fumadocs](https://fumadocs.dev/).
## Getting Started
-### Prerequisites
-
-- Node.js 20+
-- [Bun](https://bun.sh/) (recommended) or npm/pnpm/yarn
-
-### Installation
-
```bash
-# Clone the repository
-git clone https://github.com/composio
-cd docs
-
-# Install dependencies
bun install
-
-# Start development server
bun run dev
```
-Open [http://localhost:3000/docs](http://localhost:3000/docs) to view the documentation.
+Open [http://localhost:3000](http://localhost:3000).
## Project Structure
```
+fumadocs/
├── app/ # Next.js app router
-│ ├── (home)/ # Landing page
-│ ├── docs/ # Documentation layout & pages
-│ └── api/search/ # Search API endpoint
-├── content/
-│ └── docs/ # Documentation content (MDX files)
-├── lib/
-│ ├── source.ts # Content source configuration
-│ └── layout.shared.tsx # Shared layout options
-└── source.config.ts # Fumadocs MDX configuration
+├── content/ # MDX content
+│ ├── docs/
+│ ├── examples/
+│ ├── changelog/
+│ └── reference/
+├── components/ # React components
+├── lib/ # Utilities
+└── public/ # Static assets
```
-## Adding Documentation
-
-### Create a new page
+## Adding Content
-Add an MDX file to `content/docs/`:
+Create an `.mdx` file in `content/`, add frontmatter, then add to `meta.json`:
```mdx
---
-title: Your Page Title
-description: A brief description
+title: Page Title
+description: Brief description
---
-Your content here...
+Content here...
```
-### Create a section
-
-Create a folder with an `index.mdx`:
+### Components
-```
-content/docs/
-└── guides/
- ├── index.mdx # Section landing page
- ├── getting-started.mdx
- └── advanced.mdx
-```
-
-### Available Components
+```mdx
+<Tabs items={['Python', 'TypeScript']}>
+ <Tab value="Python">...</Tab>
+ <Tab value="TypeScript">...</Tab>
+</Tabs>
-Fumadocs provides built-in components you can use in MDX:
+<Callout type="info">Note</Callout>
-```mdx
<Cards>
- <Card title="Title" href="/docs/page" description="Description" />
+ <Card title="Title" href="/path" />
</Cards>
-
-<Callout type="info">
- Important information here
-</Callout>
```
-## Contributing
-
-We welcome contributions! Here's how to help:
+### Sidebar
-### Content Contributions
+Each folder has `meta.json` for ordering:
-1. Fork the repository
-2. Create a branch: `git checkout -b docs/your-topic`
-3. Add or edit MDX files in `content/docs/`
-4. Submit a pull request
-
-### Code Contributions
-
-1. Fork the repository
-2. Create a branch: `git checkout -b feature/your-feature`
-3. Make your changes
-4. Run `bun run build` to verify the build passes
-5. Submit a pull request
-
-### Guidelines
-
-- Keep documentation clear and concise
-- Use proper headings hierarchy (h2, h3, etc.)
-- Include code examples where helpful
-- Test your changes locally before submitting
+```json
+{
+ "pages": ["page-one", "page-two"]
+}
+```
-## Scripts
+## Commands
| Command | Description |
|---------|-------------|
-| `bun run dev` | Start development server |
-| `bun run build` | Build for production |
-| `bun run start` | Start production server |
+| `bun run dev` | Dev server |
+| `bun run build` | Production build |
+| `bun run types:check` | Type check |