Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: reorganize meta files
Sushmithamallesh02a0dd96a983
diff --git a/fumadocs/.claude/decisions/examples.md b/fumadocs/.claude/decisions/examples.mdnew file mode 100644index 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 patternsdiff --git a/fumadocs/.claude/TOOLKITS_PLAN.md b/fumadocs/.claude/decisions/toolkits.mdsimilarity index 100%rename from fumadocs/.claude/TOOLKITS_PLAN.mdrename to fumadocs/.claude/decisions/toolkits.mddiff --git a/fumadocs/CONTRIBUTING.md b/fumadocs/CONTRIBUTING.mddeleted file mode 100644index 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.mdindex 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 dependenciesbun install--# Start development serverbun 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 |