Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
Add CLAUDE.md with project notes and mobile considerations
Sushmithamallesh committed
Jan 4, 2026 at 23:23 UTC
97dad0ca17f63a8f42607e155ce24c952aa22bf7
1 file changed
+33
fumadocs/CLAUDE.md
new
+33
@@ -0,0 +1,33 @@
1
+# Fumadocs - Composio Documentation
2
+
3
+## Project Overview
4
+This is the Composio documentation site built with Fumadocs (Next.js-based docs framework).
5
+
6
+## Key Files
7
+- `app/global.css` - All custom styles and design tokens
8
+- `source.config.ts` - MDX collections and schema definitions
9
+- `lib/source.ts` - Source loaders and utility functions
10
+- `app/(home)/layout.tsx` - Home layout with navigation
11
+- `app/docs/layout.tsx` - Docs layout with sidebar
12
+
13
+## Design Tokens
14
+- `--composio-orange: #ea580c` - Brand accent color
15
+- `--composio-sidebar: #f7f5f2` (light) / `#252220` (dark)
16
+- `--font-sans: 'Inter'` - Body text
17
+- `--font-mono: 'IBM Plex Mono'` - Code blocks
18
+
19
+## Mobile Considerations
20
+- The nav active underline (`#nd-nav a[data-active="true"]::after`) is hidden on mobile via media query
21
+- Always test navigation changes on mobile - fumadocs uses different nav patterns for mobile vs desktop
22
+- Mobile nav is in a dropdown, desktop nav is horizontal
23
+
24
+## Common Gotchas
25
+1. **CSS variables**: Use `var(--composio-orange)` not `var(--orange)`. Check `global.css` for defined variables.
26
+2. **Date format**: Changelog dates must be YYYY-MM-DD format (validated in schema and runtime)
27
+3. **Toolkits data**: `public/data/toolkits.json` must exist - errors are thrown, not silently ignored
28
+4. **Root directory on Vercel**: Set to `fumadocs` with "Include files outside root directory" DISABLED
29
+
30
+## Deployment
31
+- Vercel project: `composio/fumadocs`
32
+- Uses `bun install` and `bun run build`
33
+- Root directory: `fumadocs` (this is a monorepo subfolder)