Docs: Fuma migration #2317
Merged
Docs: Fuma migration #2317
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Add custom theme toggle component (shadcn-style sun/moon button) - Rename "Guide" to "Docs", remove "Playground" link - Add GitHub icon and Dashboard CTA button to header - Move Dashboard to far right corner as primary CTA - Improve spacing: 2rem logo-nav gap, tighter nav item gaps - Add visual hierarchy: font-weight 500, orange underline on active - Ensure consistent 36px touch targets on all interactive elements - Add focus-visible states for accessibility - Improve muted text contrast in light/dark modes - Unify hover states with 0.15s ease transitions 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Users navigate via sidebar; footer nav adds unnecessary clutter for reference-style documentation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Removed custom ThemeToggle component and related CSS in favor of fumadocs' built-in theme switch for better reliability. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Migrate welcome page from Fern to Fumadocs format - Add YouTube embed component with rounded corners - Install shadcn/ui and add Tabs component for Python/TypeScript video switcher - Configure redirects: / and /docs → /docs/welcome - Register YouTube and Tabs components in MDX - Remove placeholder index.mdx and quickstart.mdx 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add quickstart.mdx with SDK install instructions and provider examples - Switch from shadcn tabs to fumadocs tabs for better integration - Add meta.json for page ordering (welcome → quickstart) - Include examples for OpenAI Agents, Anthropic, and Vercel AI SDK 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Create ProviderCard component with logo/icon support and language tags - Add ProviderGrid with 2-column layout and not-prose styling - Add 10 provider cards: OpenAI, Anthropic, Google Gemini, Vercel AI SDK, LangChain, LlamaIndex, OpenAI Agents, CrewAI, Mastra, Build your own - Include SVG logos for all providers - Move providers section after "Why Composio?" on welcome page 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add /llms.txt route for AI tools (lightweight doc index) - Add "For AI tools" section to welcome page with llms.txt links - Register lucide icons globally in mdx-components.tsx - Remove per-file lucide imports from MDX files (cleaner for llms-full.txt) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add changelog collection in source.config.ts with date schema - Create timeline page at /docs/changelog with date + content layout - Add changelog link to docs sidebar - Migrate 18 changelog entries from Fern (09-15-25 to 12-29-25) - Add Accordion, Accordions, Callout components to MDX - Add CHANGELOG_GUIDE.md for developers writing new entries 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Create CapabilityCard component with orange icons/headings - Add capabilities.mdx showcasing Tool Router, Auth, Tools, MCP, Triggers - Register component and icons in MDX components - Add to sidebar navigation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add individual changelog pages at /docs/changelog/YYYY/MM/DD - Add CopyLink component for copying entry URLs on click - Centralize date utilities in lib/source.ts - Use short date format (Dec 29, 2025) and orange styling - Update description to "Latest updates and announcements" 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add fetching-tools.mdx with tabbed Python/TypeScript code examples - Add sidebar section headers (Get Started, Tools and Triggers) - Position changelog correctly in sidebar (after Capabilities) - Remove underlines from prose links 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add authenticating-tools page with auth configs, Connect Link, OAuth/API key flows - Add executing-tools page covering chat completions, agentic frameworks, direct execution - Add using-triggers page with webhooks, subscriptions, and payload types - Add custom-tools page for standalone and toolkit-based tools - Add toolkit-versioning page for version pinning - Add modify-tool-behavior collapsible section with schema, input, and output modifiers - Create reusable Figure component with click-to-zoom and size variants - Create reusable Video component with performance optimizations - Add supporting images and video assets 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh
changed the title
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
- Add custom-auth-configs page for OAuth setup and white-labeling - Add programmatic-auth-configs page for SDK-based auth config creation - Add custom-auth-params page for injecting custom credentials - Add connected-accounts page for managing user connections lifecycle - Add user-management page covering User IDs, org patterns, and best practices - Add supporting images for OAuth configuration examples 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
MCP Section: - Quickstart - Creating MCP servers and user URLs - Server management - CRUD operations for MCP servers - Providers - Anthropic, OpenAI, Mastra integrations Resources Section: - CLI - Installation, authentication, type generation - Debugging Info - Project/org IDs for support Migration Guide Section: - Overview - Links to available guides - New SDK migration - Comprehensive SDK v3 migration guide - Toolkit versioning - Breaking change migration Troubleshooting Section: - Overview with quick links - API, Authentication, CLI, Dashboard, MCP - SDKs, Tools & Toolkits, Triggers 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Rename welcome.mdx to index.mdx for cleaner /docs URL - Add complete Tool Router documentation section: - Quickstart guide with MCP and native tool integrations - Core concepts: users/sessions, authentication, tools/toolkits - Guides: in-chat auth, manual auth, multi-account, white-labeling - MCP client integration guide - Migration guide from beta to stable - Fix navigation active state for Tool Router tab - Update redirects for new URL structure
- Integrate fumadocs-openapi for auto-generated API docs from OpenAPI spec - Add filtered OpenAPI spec script (scripts/fetch-openapi.mjs) to remove duplicate endpoints and internal APIs (CLI, Admin, Profiling) - Create API Reference landing page with authentication docs and videos - Support both x-api-key and x-org-api-key authentication methods - Add instructional videos for fetching API keys 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Fumadocs automatically renders title and description from frontmatter, so the generator was creating duplicate content by also including # Title and description paragraph in the MDX body. Changes: - Remove duplicate # heading and description from generateClassMdx() - Remove duplicate heading from index template - Regenerate all TypeScript SDK docs 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Regenerated lockfile with pnpm 10.17.0 to fix CI config mismatch. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Handle filepath as Path | list[Path] correctly - Add explicit Optional type annotation for prop_to_class parameter 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh
force-pushed
the
docs/fuma
branch
from
b46c3ce to
39cff03
Compare
Sushmithamallesh
force-pushed
the
docs/fuma
branch
from
39cff03 to
42669fa
Compare
- Add detect-changes job to only run relevant SDK generator - Add workflow_dispatch input to select which SDK to generate - Add uv caching for Python job 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh
force-pushed
the
docs/fuma
branch
from
42669fa to
0dcacdc
Compare
- Move planning docs to .claude/decisions/ - Merge CONTRIBUTING.md into README.md - Add examples.md (from user interviews) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sushmithamallesh
changed the title
- Change site prop from "My App" to "Composio" - Remove unused lang parameter from generateStaticParams 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Wrap getPages() call in try-catch to handle potential errors gracefully 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
haxzie
approved these changes
Jan 7, 2026
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Explain the motivation and context for this change. Link to any related issues.
Fixes #
Changes
Type of change
How Has This Been Tested?
Describe the tests you ran and instructions so reviewers can reproduce. Include any relevant config/versions.
Screenshots (if applicable)
Checklist
Additional context