@devries-cameron20 / composio Mirror · read-only / commits / 97dad0ca1
Fork 0

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, 15:45 UTC

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)