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.

move docs around to make it simpler to understand

Rahul Tarak1771148430da
diff --git a/.gitignore b/.gitignore
index 155c39b82..11fa20fbc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -43,8 +43,8 @@ lerna-debug.log*
fern/tools
fern/apis/openapi.yml
fern/apis/openapi-mcp.json
-fern/pages/
-fern/docs/sdk/
+fern/pages/dist/
+fern/pages/sdk/
# Python cache files
__pycache__/
diff --git a/fern/docs.yml b/fern/docs.yml
index 9aeb75177..870891b48 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -123,78 +123,78 @@ navigation:
skip-slug: true
contents:
- page: Welcome
- path: pages/welcome.mdx
+ path: pages/dist/welcome.mdx
slug: welcome
- page: Quickstart
- path: pages/quickstart.mdx
+ path: pages/dist/quickstart.mdx
slug: quickstart
- page: IDE and Agent Setup
- path: pages/dev-setup.mdx
+ path: pages/dist/dev-setup.mdx
slug: dev-setup
- page: Providers
- path: pages/providers.mdx
+ path: pages/dist/providers.mdx
slug: providers
- section: Tools
icon: tools
skip-slug: true
contents:
- page: Executing Tools
- path: pages/executing-tools.mdx
+ path: pages/dist/executing-tools.mdx
slug: executing-tools
- page: Authenticating Tools
- path: pages/authenticating-tools.mdx
+ path: pages/dist/authenticating-tools.mdx
slug: authenticating-tools
- page: Fetch and Filter Tools
- path: pages/fetching-tools.mdx
+ path: pages/dist/fetching-tools.mdx
slug: fetching-tools
- section: Modifiers
slug: modifiers
contents:
- page: Schema Modifiers
- path: pages/schema-modifiers.mdx
+ path: pages/dist/schema-modifiers.mdx
slug: schema-modifiers
- page: Before Tool Execution
- path: pages/before-execution-modifiers.mdx
+ path: pages/dist/before-execution-modifiers.mdx
slug: before-execution
- page: After Tool Execution
- path: pages/after-execution-modifiers.mdx
+ path: pages/dist/after-execution-modifiers.mdx
slug: after-execution
- page: Custom tools
- path: pages/custom-tools.mdx
+ path: pages/dist/custom-tools.mdx
slug: custom-tools
- section: Authentication
icon: lock
skip-slug: true
contents:
- page: Custom Auth Configs
- path: pages/custom-auth-configs.mdx
+ path: pages/dist/custom-auth-configs.mdx
slug: custom-auth-configs
- page: Programmatic Auth Configs
- path: pages/programmatic-auth-configs.mdx
+ path: pages/dist/programmatic-auth-configs.mdx
slug: programmatic-auth-configs
- page: Custom Auth Parameters
- path: pages/custom-auth-params.mdx
+ path: pages/dist/custom-auth-params.mdx
slug: custom-auth-params
- section: Triggers
icon: bolt
skip-slug: true
contents:
- page: Using Triggers
- path: pages/using-triggers.mdx
+ path: pages/dist/using-triggers.mdx
slug: using-triggers
- section: MCP
icon: server
skip-slug: true
contents:
- page: Introduction
- path: pages/introduction.mdx
+ path: pages/dist/introduction.mdx
slug: mcp-introduction
- section: Resources
icon: book
skip-slug: true
contents:
- page: Migration Guide
- path: pages/migration-guide.mdx
+ path: pages/dist/migration-guide.mdx
slug: migration
- tab: examples
layout:
@@ -203,27 +203,27 @@ navigation:
skip-slug: true
contents:
- page: Hello World
- path: pages/hello-world.mdx
+ path: pages/dist/hello-world.mdx
slug: examples/hello-world
- page: Sample Script
- path: pages/sample-script.mdx
+ path: pages/dist/sample-script.mdx
slug: examples/sample-script
- page: Basic Hono Server
- path: pages/sample-webserver.mdx
+ path: pages/dist/sample-webserver.mdx
slug: examples/sample-webserver
- section: Full Stack Applications
icon: globe
skip-slug: true
contents:
- page: Full Stack Chat App
- path: pages/vercel-composio.mdx
+ path: pages/dist/vercel-composio.mdx
slug: examples/chat-app
- section: Productivity & Automation
icon: zap
skip-slug: true
contents:
- page: Gmail Reaper
- path: pages/gmail-filterer.mdx
+ path: pages/dist/gmail-filterer.mdx
slug: examples/gmail-reaper
- tab: providers
layout:
@@ -231,23 +231,23 @@ navigation:
icon: code
contents:
- page: OpenAI Provider
- path: pages/openai.mdx
+ path: pages/dist/openai.mdx
- page: Anthropic Provider
- path: pages/anthropic.mdx
+ path: pages/dist/anthropic.mdx
- page: LangChain Provider
- path: pages/langchain.mdx
+ path: pages/dist/langchain.mdx
- page: CrewAI Provider
- path: pages/crewai.mdx
+ path: pages/dist/crewai.mdx
- page: Vercel AI SDK Provider
- path: pages/vercel.mdx
+ path: pages/dist/vercel.mdx
- page: Google ADK Provider
- path: pages/google-adk.mdx
+ path: pages/dist/google-adk.mdx
- page: OpenAI Agents Provider
- path: pages/openai-agents.mdx
+ path: pages/dist/openai-agents.mdx
- page: Mastra Provider
- path: pages/mastra.mdx
+ path: pages/dist/mastra.mdx
- page: Custom Provider
- path: pages/custom.mdx
+ path: pages/dist/custom.mdx
- tab: tools
layout:
- section: Tools
@@ -866,7 +866,7 @@ navigation:
icon: python
contents:
- page: Python SDK Reference
- path: pages/sdk/python/sdk-reference.md
+ path: pages/dist/sdk/python/sdk-reference.md
- section: TypeScript
icon: typescript
contents:
@@ -874,32 +874,32 @@ navigation:
slug: core-classes
contents:
- page: Composio
- path: pages/sdk/typescript/composio/classes/Composio.mdx
+ path: pages/dist/sdk/typescript/composio/classes/Composio.mdx
- page: ComposioProvider
- path: pages/sdk/typescript/provider/ComposioProvider/classes/ComposioProvider.mdx
+ path: pages/dist/sdk/typescript/provider/ComposioProvider/classes/ComposioProvider.mdx
- page: OpenAIProvider
- path: pages/sdk/typescript/provider/OpenAIProvider/classes/OpenAIProvider.mdx
+ path: pages/dist/sdk/typescript/provider/OpenAIProvider/classes/OpenAIProvider.mdx
- page: BaseAgenticProvider
- path: pages/sdk/typescript/provider/BaseProvider/classes/BaseAgenticProvider.mdx
+ path: pages/dist/sdk/typescript/provider/BaseProvider/classes/BaseAgenticProvider.mdx
- page: BaseNonAgenticProvider
- path: pages/sdk/typescript/provider/BaseProvider/classes/BaseNonAgenticProvider.mdx
+ path: pages/dist/sdk/typescript/provider/BaseProvider/classes/BaseNonAgenticProvider.mdx
- section: Models
slug: models
contents:
- page: Tools
- path: pages/sdk/typescript/models/Tools/classes/Tools.mdx
+ path: pages/dist/sdk/typescript/models/Tools/classes/Tools.mdx
- page: Toolkits
- path: pages/sdk/typescript/models/Toolkits/classes/Toolkits.mdx
+ path: pages/dist/sdk/typescript/models/Toolkits/classes/Toolkits.mdx
- page: Triggers
- path: pages/sdk/typescript/models/Triggers/classes/Triggers.mdx
+ path: pages/dist/sdk/typescript/models/Triggers/classes/Triggers.mdx
- page: AuthConfigs
- path: pages/sdk/typescript/AuthConfigs/classes/AuthConfigs.mdx
+ path: pages/dist/sdk/typescript/AuthConfigs/classes/AuthConfigs.mdx
- page: ConnectedAccounts
- path: pages/sdk/typescript/ConnectedAccounts/classes/ConnectedAccounts.mdx
+ path: pages/dist/sdk/typescript/ConnectedAccounts/classes/ConnectedAccounts.mdx
- page: ConnectionRequest
- path: pages/sdk/typescript/ConnectionRequest/classes/ConnectionRequest.mdx
+ path: pages/dist/sdk/typescript/ConnectionRequest/classes/ConnectionRequest.mdx
- page: CustomTools
- path: pages/sdk/typescript/CustomTools/classes/CustomTools.mdx
+ path: pages/dist/sdk/typescript/CustomTools/classes/CustomTools.mdx
- tab: api-reference
layout:
- section: API Reference
diff --git a/fern/generators/python-sdk/generate_docs.py b/fern/generators/python-sdk/generate_docs.py
index 675270a1a..2c5845dda 100644
--- a/fern/generators/python-sdk/generate_docs.py
+++ b/fern/generators/python-sdk/generate_docs.py
@@ -18,7 +18,7 @@ def main():
"""Generate SDK documentation."""
fern_dir = Path(__file__).parent.parent.parent
source_dir = fern_dir / "generators" / "python-sdk" / "templates"
- output_dir = fern_dir / "docs" / "sdk" / "python"
+ output_dir = fern_dir / "pages" / "dist" / "sdk" / "python"
print("Generating Composio Python SDK documentation...")
print(f"Source: {source_dir}")
diff --git a/fern/pages/index.mdx b/fern/pages/index.mdx
deleted file mode 100644
index 456b7acbe..000000000
--- a/fern/pages/index.mdx
+++ /dev/null
@@ -1,171 +0,0 @@
----
-no-image-zoom: true
----
-
-export const LandingPageCard = ({ href, title, imgSrc, description }) => (
- <div className="rounded-lg bg-[#F5F4F2] dark:bg-[#0F0F0F] px-6 py-5 hover:bg-[#E9E6DE] dark:hover:bg-[#292929] md:p-8">
- <a
- href={href}
- target="_self"
- className="flex h-full flex-col justify-between"
- style={{ textDecoration: 'none' }}
- >
- <div className="mb-5 flex flex-col justify-between gap-5">
- <h2 className="lg:min-h-20 [@media(min-width:1181px)]:min-h-0">
- {title}
- </h2>
- <img src={imgSrc} alt={title} />
- <p className="p-lg">{description}</p>
- </div>
- <div className="mt-2 text-sm text-[#2D4CB9] dark:text-[#4C6EE6] md:mt-0 md:self-end">
- {"GET STARTED"}
- <div className="ml-2 inline-block group-hover:no-underline">
- <svg
- width="12"
- height="11"
- viewBox="0 0 12 11"
- fill="none"
- xmlns="http://www.w3.org/2000/svg"
- style={{ transform: "rotate(-90deg)" }}
- >
- <path
- d="M6 10.75L0.75 5.31686L1.74907 4.27907L5.2556 8.00291L5.2556 0.25L6.7444 0.25L6.7444 8.00291L10.2509 4.27907L11.25 5.31686L6 10.75Z"
- fill="currentColor"
- ></path>
- </svg>
- </div>
- </div>
- </a>
- </div>
-);
-
-export const EndpointLink = ({ href, title }) => (
- <a
- href={href}
- className="group flex cursor-pointer flex-row text-sm !font-normal text-[#2D4CB9] dark:text-[#4C6EE6]"
- rel="noreferrer"
- target="_self"
- >
- {title}
- <span className="duration-400 flex items-center transition-all ease-in-out group-hover:pl-1 group-hover:pr-2">
- <div className="ml-2 inline-block text-sm !text-[#2D4CB9] group-hover:no-underline">
- <svg
- width="12"
- height="11"
- viewBox="0 0 12 11"
- fill="none"
- xmlns="http://www.w3.org/2000/svg"
- style={{ transform: "rotate(-90deg)" }}
- >
- <path
- d="M6 10.75L0.75 5.31686L1.74907 4.27907L5.2556 8.00291L5.2556 0.25L6.7444 0.25L6.7444 8.00291L10.2509 4.27907L11.25 5.31686L6 10.75Z"
- fill="currentColor"
- ></path>
- </svg>
- </div>
- </span>
- </a>
-);
-
-export const cards = [
- {
- href: "/docs",
- imgSrc: "https://fern-image-hosting.s3.amazonaws.com/cohere/8da77c9-Frame_138972.png",
- title: "Guides",
- description:
- "Understand how to use the Composio SDK and platform on a deeper level. Build with authenticated tools, triggers and more.",
- },
- {
- href: "/api-reference/",
- imgSrc: "https://fern-image-hosting.s3.amazonaws.com/cohere/8ff146a-Group_138977.png",
- title: "Reference",
- description:
- "Use Composio's tools and MCP servers into your agents with just a few lines of code.",
- },
- {
- href: "/cookbooks",
- imgSrc: "https://fern-image-hosting.s3.amazonaws.com/cohere/7fca92c-Group_138977_2.png",
- title: "Cookbooks",
- description:
- "A collection of resources to help developers get up and running with Composio.",
- },
-];
-
-export const frameworks = [
- {
- href: "/frameworks/langchain",
- title: "LangChain",
- },
- {
- href: "/frameworks/langgraph",
- title: "LangGraph",
- },
- {
- href: "/frameworks/crewai",
- title: "CrewAI",
- },
- {
- href: "/frameworks/vercel",
- title: "Vercel",
- },
- {
- href: "/frameworks/autogen",
- title: "Autogen",
- },
-];
-
-<div className="m-auto max-w-[1195px] flex-grow overflow-y-auto px-8 pt-10 md:p-10 md:pb-14">
- <div className="flex flex-col gap-5 md:!grid md:grid-cols-2 md:gap-10 md:pb-7 lg:!grid-cols-3 lg:gap-x-8 lg:gap-y-10 lg:pb-16">
- {cards.map((card) => (
- <LandingPageCard
- key={card.href}
- href={card.href}
- imgSrc={card.imgSrc}
- title={card.title}
- description={card.description}
- />
- ))}
- <a href="/frameworks" className="col-span-2" style={{ textDecoration: 'none' }}>
- <div className="mb-8 flex flex-col gap-9 rounded-lg bg-[#F5F4F2] dark:bg-[#0F0F0F] px-6 py-5 hover:bg-[#E9E6DE] dark:hover:bg-[#292929] md:!flex-row md:items-end md:gap-16 md:p-8 lg:gap-10">
- <div className="md:w-1/2">
- <h2 className="mb-8 mt-4 md:mt-0">Frameworks</h2>
- <p className="p-lg w-full">
- Build with frameworks that support Composio's tools and MCP servers.
- </p>
- </div>
- <div className="grid grid-cols-2 gap-5 md:w-1/2 md:gap-10 lg:w-1/3 lg:gap-8">
- {frameworks.map((framework) => (
- <EndpointLink key={framework.href} {...framework} />
- ))}
- </div>
- </div>
- </a>
- </div>
- <div
- className="block h-full w-full rounded-lg bg-cover bg-no-repeat p-6 md:hidden"
- style={{
- backgroundImage: "url('https://fern-image-hosting.s3.amazonaws.com/cohere/ddd53ed-Mask_group.png')",
- }}
- >
- <a
- href="https://cohere.com/llmu"
- target="_blank"
- className="flex h-full w-full flex-col justify-between !text-white md:!flex-row"
- >
- <div className="flex h-full flex-col justify-between">
- <div className="flex flex-row">
- <img
- src="https://fern-image-hosting.s3.amazonaws.com/cohere/9d0694c-Symbol.svg"
- alt=""
- className="h-7 w-7 lg:h-10 lg:w-10"
- />
- <h2 className="h3 mb-28 ml-5 mt-0">LLM University</h2>
- </div>
- <p className="p-lg !text-white">
- New to NLP? Learn about Natural Language processing and Large Language
- Models through our structured curriculum.
- </p>
- </div>
- </a>
- </div>
-</div>
diff --git a/fern/docs/authentication/custom-auth-configs.mdx b/fern/pages/src/authentication/custom-auth-configs.mdx
similarity index 94%
rename from fern/docs/authentication/custom-auth-configs.mdx
rename to fern/pages/src/authentication/custom-auth-configs.mdx
index 34705a822..bdb26f565 100644
--- a/fern/docs/authentication/custom-auth-configs.mdx
+++ b/fern/pages/src/authentication/custom-auth-configs.mdx
@@ -20,7 +20,7 @@ You'll need to customize the auth config in cases where you want to add in a dif
<Tab title="Example: PostHog">
You may change the subdomain for the PostHog toolkit to match your own instance.
<Frame background="subtle" title="PostHog Auth Config Settings">
-<img src="../assets/images/custom-auth-posthog.png" />
+<img src="../../assets/images/custom-auth-posthog.png" />
</Frame>
</Tab>
<Tab title="Example: Hubspot">
@@ -29,7 +29,7 @@ For Hubspot you may customize everything here. For each auth scheme there is a d
If you choose to use your own developer app for OAuth2 scheme, you will have to provide the client ID and client secret.
<Frame background="subtle" title="Hubspot Auth Config Settings">
-<img src="../assets/images/custom-auth-hubspot.png" />
+<img src="../../assets/images/custom-auth-hubspot.png" />
</Frame>
</Tab>
</Tabs>
@@ -56,12 +56,12 @@ Examples for Google and GitHub:
<Tabs>
<Tab title="Google">
<Frame background="subtle" caption="Google OAuth Configuration">
- <img src="../assets/images/google-oauth-config.png" />
+ <img src="../../assets/images/google-oauth-config.png" />
</Frame>
</Tab>
<Tab title="GitHub">
<Frame background="subtle" caption="GitHub OAuth Configuration">
- <img src="../assets/images/github-oauth-config.png" />
+ <img src="../../assets/images/github-oauth-config.png" />
</Frame>
</Tab>
</Tabs>
@@ -84,7 +84,7 @@ Once you have the OAuth credentials, you can add them to the auth config in the
4. Click **"Create Integration"** once done!
<Frame background="subtle" title="Auth Config Settings">
- <img src="../assets/images/integration-step-3-0.png" />
+ <img src="../../assets/images/integration-step-3-0.png" />
</Frame>
As usual, copy and use the auth config ID starting with `ac_` in your application code via a secret manager.
@@ -127,7 +127,7 @@ print(connected_account)
By default the users will see an OAuth screen like the one below:
<Frame background="subtle" caption="Composio's Domain in OAuth Consent Screen">
- <img src="../assets/images/oauth-branding.png" />
+ <img src="../../assets/images/oauth-branding.png" />
</Frame>
The OAuth redirect URL is surfaced in the some OAuth providers' consent screens. This may cause confusion for some users as that URL is not of the same domain as the application.
@@ -206,7 +206,7 @@ def authorize_app(toolkit: str):
Specify the your custom redirect URI in the auth config settings!
<Frame background="subtle" title="Auth Config Settings">
-<img src="../assets/images/custom-redirect-uri.png" />
+<img src="../../assets/images/custom-redirect-uri.png" />
</Frame>
</Step>
</Steps>
diff --git a/fern/docs/authentication/custom-auth-params.mdx b/fern/pages/src/authentication/custom-auth-params.mdx
similarity index 100%
rename from fern/docs/authentication/custom-auth-params.mdx
rename to fern/pages/src/authentication/custom-auth-params.mdx
diff --git a/fern/docs/authentication/programmatic-auth-configs.mdx b/fern/pages/src/authentication/programmatic-auth-configs.mdx
similarity index 100%
rename from fern/docs/authentication/programmatic-auth-configs.mdx
rename to fern/pages/src/authentication/programmatic-auth-configs.mdx
diff --git a/fern/docs/changelog/2025-06-01.md b/fern/pages/src/changelog/2025-06-01.md
similarity index 100%
rename from fern/docs/changelog/2025-06-01.md
rename to fern/pages/src/changelog/2025-06-01.md
diff --git a/fern/docs/examples/gmail-filterer.mdx b/fern/pages/src/examples/gmail-filterer.mdx
similarity index 100%
rename from fern/docs/examples/gmail-filterer.mdx
rename to fern/pages/src/examples/gmail-filterer.mdx
diff --git a/fern/docs/examples/hello-world.mdx b/fern/pages/src/examples/hello-world.mdx
similarity index 100%
rename from fern/docs/examples/hello-world.mdx
rename to fern/pages/src/examples/hello-world.mdx
diff --git a/fern/docs/examples/sample-script.mdx b/fern/pages/src/examples/sample-script.mdx
similarity index 100%
rename from fern/docs/examples/sample-script.mdx
rename to fern/pages/src/examples/sample-script.mdx
diff --git a/fern/docs/examples/sample-webserver.mdx b/fern/pages/src/examples/sample-webserver.mdx
similarity index 100%
rename from fern/docs/examples/sample-webserver.mdx
rename to fern/pages/src/examples/sample-webserver.mdx
diff --git a/fern/docs/examples/vercel-composio.mdx b/fern/pages/src/examples/vercel-composio.mdx
similarity index 96%
rename from fern/docs/examples/vercel-composio.mdx
rename to fern/pages/src/examples/vercel-composio.mdx
index 8682c3f95..e805a411d 100644
--- a/fern/docs/examples/vercel-composio.mdx
+++ b/fern/pages/src/examples/vercel-composio.mdx
@@ -27,7 +27,7 @@ Learn how to create auth configs [here](/docs/authenticating-tools#creating-an-a
Once done, your auth configs will be available in the [Composio dashboard](https://app.composio.dev/integrations).
<Frame>
- <img src="../assets/images/examples/auth-configs.png" alt="Auth configs" />
+ <img src="../../assets/images/examples/auth-configs.png" alt="Auth configs" />
</Frame>
### Save auth config IDs to environment variables
@@ -62,7 +62,7 @@ The Composio SDK is meant to be used only in server-side code. For client-side f
In order to list the toolkits and their connection status, we create a Next.js API route to fetch the toolkits using Composio SDK.
<Frame>
- <img src="../assets/images/examples/toolkits.png" />
+ <img src="../../assets/images/examples/toolkits.png" />
</Frame>
### 1. Listing connected accounts
@@ -128,7 +128,7 @@ Users need to connect and disconnect their accounts from the chatbot to enable t
When a user wants to connect their account, we create a connection request that redirects them to the OAuth provider:
<Frame>
- <img src="../assets/images/examples/create-connection.png" />
+ <img src="../../assets/images/examples/create-connection.png" />
</Frame>
```typescript app/api/connections/initiate/route.ts
@@ -155,7 +155,7 @@ export async function POST(request: Request) {
After initiating a connection, we need to wait for the OAuth flow to complete. We check the connection status to know when it's ready to use:
<Frame>
- <img src="../assets/images/examples/connection-status.png" />
+ <img src="../../assets/images/examples/connection-status.png" />
</Frame>
```typescript app/api/connections/status/route.ts
@@ -260,7 +260,7 @@ export async function POST(request: Request) {
By default, tool calls appear as raw JSON in the chat interface. To create a better user experience, we can build custom components that display tool calls with proper formatting and loading states.
<Frame>
- <img src="../assets/images/examples/custom-tool-component.png" />
+ <img src="../../assets/images/examples/custom-tool-component.png" />
</Frame>
You can find the `ToolCall` component at `components/tool-call.tsx`. Here's how to integrate it into your message rendering:
diff --git a/fern/docs/get-started/dev-setup.mdx b/fern/pages/src/get-started/dev-setup.mdx
similarity index 98%
rename from fern/docs/get-started/dev-setup.mdx
rename to fern/pages/src/get-started/dev-setup.mdx
index 1710e5451..e4f03af74 100644
--- a/fern/docs/get-started/dev-setup.mdx
+++ b/fern/pages/src/get-started/dev-setup.mdx
@@ -15,7 +15,7 @@ This guide explains how to setup your IDE, and coding agents to help you ship fa
To optimize your experience building with Composio, you can add instructions to Cursor's system settings.
<Frame>
- <img src="../assets/images/cursor-settings.png" alt="Cursor settings" />
+ <img src="../../assets/images/cursor-settings.png" alt="Cursor settings" />
</Frame>
Add the following to your Cursor "Rules for AI":
diff --git a/fern/docs/get-started/providers.mdx b/fern/pages/src/get-started/providers.mdx
similarity index 91%
rename from fern/docs/get-started/providers.mdx
rename to fern/pages/src/get-started/providers.mdx
index 05cdeb664..162c144e4 100644
--- a/fern/docs/get-started/providers.mdx
+++ b/fern/pages/src/get-started/providers.mdx
@@ -9,7 +9,7 @@ Every LLM framework and provider essentially does the same thing - **tool callin
<Frame>
<img
- src="../assets/images/providers-and-toolsets.png"
+ src="../../assets/images/providers-and-toolsets.png"
alt="Providers and Toolsets"
width="400px"
height="auto"
@@ -121,21 +121,21 @@ composio = Composio(provider=OpenAIAgentsProvider())
<CardGroup cols={3}>
<Card
title="OpenAI Provider"
- icon={<img src="../assets/images/openai-logo.svg" width="24" height="24" />}
+ icon={<img src="../../assets/images/openai-logo.svg" width="24" height="24" />}
href="/providers/openai"
>
Integrate with OpenAI's tool calling and agents.
</Card>
<Card
title="Anthropic Provider"
- icon={<img src="../assets/images/anthropic-logo.svg" width="24" height="24" />}
+ icon={<img src="../../assets/images/anthropic-logo.svg" width="24" height="24" />}
href="/providers/anthropic"
>
Use Anthropic's Claude models with Composio tools.
</Card>
<Card
title="Gemini Provider"
- icon={<img src="../assets/images/google-logo.svg" width="24" height="24" />}
+ icon={<img src="../../assets/images/google-logo.svg" width="24" height="24" />}
href="/providers/google-adk"
>
Integrate with Google's Gemini models.
@@ -146,7 +146,7 @@ composio = Composio(provider=OpenAIAgentsProvider())
<CardGroup cols={3}>
<Card
title="LangGraph Provider"
- icon={<img src="../assets/images/langgraph-logo.svg"/>}
+ icon={<img src="../../assets/images/langgraph-logo.svg"/>}
href="/providers/langgraph"
>
Add tools to LangGraph agent flows.
@@ -160,7 +160,7 @@ composio = Composio(provider=OpenAIAgentsProvider())
</Card>
<Card
title="Vercel AI SDK Provider"
- icon={<img src="../assets/images/vercel-logo.svg" width="24" height="24" />}
+ icon={<img src="../../assets/images/vercel-logo.svg" width="24" height="24" />}
href="/providers/vercel"
>
Use Composio tools with Vercel's AI SDK.
diff --git a/fern/docs/get-started/quickstart.mdx b/fern/pages/src/get-started/quickstart.mdx
similarity index 100%
rename from fern/docs/get-started/quickstart.mdx
rename to fern/pages/src/get-started/quickstart.mdx
diff --git a/fern/docs/get-started/welcome.mdx b/fern/pages/src/get-started/welcome.mdx
similarity index 94%
rename from fern/docs/get-started/welcome.mdx
rename to fern/pages/src/get-started/welcome.mdx
index 213cae723..153c41ba9 100644
--- a/fern/docs/get-started/welcome.mdx
+++ b/fern/pages/src/get-started/welcome.mdx
@@ -7,7 +7,7 @@ hide-nav-links: false
---
<Frame>
- <img src="../assets/images/hero.png" alt="Composio introduction image" />
+ <img src="../../assets/images/hero.png" alt="Composio introduction image" />
</Frame>
<Tip>
Give your AI IDE access to Composio's documentation using our llms.txt files: ([short
diff --git a/fern/docs/index.mdx b/fern/pages/src/index.mdx
similarity index 100%
rename from fern/docs/index.mdx
rename to fern/pages/src/index.mdx
diff --git a/fern/docs/mcp/introduction.mdx b/fern/pages/src/mcp/introduction.mdx
similarity index 100%
rename from fern/docs/mcp/introduction.mdx
rename to fern/pages/src/mcp/introduction.mdx
diff --git a/fern/docs/migration-guide.mdx b/fern/pages/src/migration-guide.mdx
similarity index 100%
rename from fern/docs/migration-guide.mdx
rename to fern/pages/src/migration-guide.mdx
diff --git a/fern/docs/providers/anthropic.mdx b/fern/pages/src/providers/anthropic.mdx
similarity index 100%
rename from fern/docs/providers/anthropic.mdx
rename to fern/pages/src/providers/anthropic.mdx
diff --git a/fern/docs/providers/crewai.mdx b/fern/pages/src/providers/crewai.mdx
similarity index 100%
rename from fern/docs/providers/crewai.mdx
rename to fern/pages/src/providers/crewai.mdx
diff --git a/fern/docs/providers/custom.mdx b/fern/pages/src/providers/custom.mdx
similarity index 100%
rename from fern/docs/providers/custom.mdx
rename to fern/pages/src/providers/custom.mdx
diff --git a/fern/docs/providers/google-adk.mdx b/fern/pages/src/providers/google-adk.mdx
similarity index 100%
rename from fern/docs/providers/google-adk.mdx
rename to fern/pages/src/providers/google-adk.mdx
diff --git a/fern/docs/providers/langchain.mdx b/fern/pages/src/providers/langchain.mdx
similarity index 100%
rename from fern/docs/providers/langchain.mdx
rename to fern/pages/src/providers/langchain.mdx
diff --git a/fern/docs/providers/mastra.mdx b/fern/pages/src/providers/mastra.mdx
similarity index 100%
rename from fern/docs/providers/mastra.mdx
rename to fern/pages/src/providers/mastra.mdx
diff --git a/fern/docs/providers/openai-agents.mdx b/fern/pages/src/providers/openai-agents.mdx
similarity index 100%
rename from fern/docs/providers/openai-agents.mdx
rename to fern/pages/src/providers/openai-agents.mdx
diff --git a/fern/docs/providers/openai.mdx b/fern/pages/src/providers/openai.mdx
similarity index 100%
rename from fern/docs/providers/openai.mdx
rename to fern/pages/src/providers/openai.mdx
diff --git a/fern/docs/providers/vercel.mdx b/fern/pages/src/providers/vercel.mdx
similarity index 100%
rename from fern/docs/providers/vercel.mdx
rename to fern/pages/src/providers/vercel.mdx
diff --git a/fern/docs/tool-calling/after-execution-modifiers.mdx b/fern/pages/src/tool-calling/after-execution-modifiers.mdx
similarity index 98%
rename from fern/docs/tool-calling/after-execution-modifiers.mdx
rename to fern/pages/src/tool-calling/after-execution-modifiers.mdx
index 56d8e88f5..2f5a71a42 100644
--- a/fern/docs/tool-calling/after-execution-modifiers.mdx
+++ b/fern/pages/src/tool-calling/after-execution-modifiers.mdx
@@ -18,7 +18,7 @@ These modifiers are called after the tool is executed by the LLM. This allows yo
- Convert the output to a different format before returning it to the agent.
<Frame>
- <img src="../assets/images/after-execute.png" alt="After Execution Modifier" />
+ <img src="../../assets/images/after-execute.png" alt="After Execution Modifier" />
</Frame>
<Note>
diff --git a/fern/docs/tool-calling/authenticating-tools.mdx b/fern/pages/src/tool-calling/authenticating-tools.mdx
similarity index 98%
rename from fern/docs/tool-calling/authenticating-tools.mdx
rename to fern/pages/src/tool-calling/authenticating-tools.mdx
index 6d7c0f8f3..eada51343 100644
--- a/fern/docs/tool-calling/authenticating-tools.mdx
+++ b/fern/pages/src/tool-calling/authenticating-tools.mdx
@@ -29,13 +29,13 @@ Once created, it's reusable across multiple users.
<Step title="Select App">
Navigate to the [Apps page](https://app.composio.dev/apps) and choose the app you want to integrate (for example, Google Sheets).
<Frame background="subtle" title="Application Selection Screen">
- <img src="../assets/images/integration-step-1-0.png" />
+ <img src="../../assets/images/integration-step-1-0.png" />
</Frame>
</Step>
<Step title="Initiate Setup">
Click the **"Setup Integration"** button.
<Frame background="subtle" title="Auth Config Setup Interface">
- <img src="../assets/images/integration-step-2-0.png" />
+ <img src="../../assets/images/integration-step-2-0.png" />
</Frame>
</Step>
<Step title="Configure Auth Config Settings">
@@ -48,7 +48,7 @@ Once created, it's reusable across multiple users.
</Note>
<Frame background="subtle" title="Auth Config Settings">
- <img src="../assets/images/auth-config-creation.png" />
+ <img src="../../assets/images/auth-config-creation.png" />
</Frame>
</Step>
<Step title="Create and Get ID">
diff --git a/fern/docs/tool-calling/before-execution-modifiers.mdx b/fern/pages/src/tool-calling/before-execution-modifiers.mdx
similarity index 98%
rename from fern/docs/tool-calling/before-execution-modifiers.mdx
rename to fern/pages/src/tool-calling/before-execution-modifiers.mdx
index 56db2a2f5..7ad6bd9f2 100644
--- a/fern/docs/tool-calling/before-execution-modifiers.mdx
+++ b/fern/pages/src/tool-calling/before-execution-modifiers.mdx
@@ -18,7 +18,7 @@ These modifiers are called before the tool is executed by the LLM. This allows y
- Overriding the arguments emitted by the LLM.
<Frame>
- <img src="../assets/images/before-execute.png" alt="Before Execution Modifier" />
+ <img src="../../assets/images/before-execute.png" alt="Before Execution Modifier" />
</Frame>
<Note>
diff --git a/fern/docs/tool-calling/custom-tools.mdx b/fern/pages/src/tool-calling/custom-tools.mdx
similarity index 100%
rename from fern/docs/tool-calling/custom-tools.mdx
rename to fern/pages/src/tool-calling/custom-tools.mdx
diff --git a/fern/docs/tool-calling/executing-tools.mdx b/fern/pages/src/tool-calling/executing-tools.mdx
similarity index 100%
rename from fern/docs/tool-calling/executing-tools.mdx
rename to fern/pages/src/tool-calling/executing-tools.mdx
diff --git a/fern/docs/tool-calling/fetching-tools.mdx b/fern/pages/src/tool-calling/fetching-tools.mdx
similarity index 100%
rename from fern/docs/tool-calling/fetching-tools.mdx
rename to fern/pages/src/tool-calling/fetching-tools.mdx
diff --git a/fern/docs/tool-calling/schema-modifiers.mdx b/fern/pages/src/tool-calling/schema-modifiers.mdx
similarity index 98%
rename from fern/docs/tool-calling/schema-modifiers.mdx
rename to fern/pages/src/tool-calling/schema-modifiers.mdx
index 5e31e194b..69d631d54 100644
--- a/fern/docs/tool-calling/schema-modifiers.mdx
+++ b/fern/pages/src/tool-calling/schema-modifiers.mdx
@@ -13,7 +13,7 @@ Schema modifiers are part of Composio SDK's powerful middleware capabilities tha
Schema modifiers transform a tool's schema before the tool is seen by an agent.
<Frame>
- <img src="../assets/images/schema-modifier.png" alt="Schema Modifier" />
+ <img src="../../assets/images/schema-modifier.png" alt="Schema Modifier" />
</Frame>
**Useful for:** - Adding arguments to the tool. For example, adding a `thought` argument to the tool
to prompt the agent to explain the reasoning. - Hiding arguments from the tool. In cases where the
diff --git a/fern/docs/triggers/using-triggers.mdx b/fern/pages/src/triggers/using-triggers.mdx
similarity index 95%
rename from fern/docs/triggers/using-triggers.mdx
rename to fern/pages/src/triggers/using-triggers.mdx
index b1617b2ea..8e5c5f131 100644
--- a/fern/docs/triggers/using-triggers.mdx
+++ b/fern/pages/src/triggers/using-triggers.mdx
@@ -11,7 +11,7 @@ Triggers act as a notification system for your AI applications, enabling your ag
When these events take place, triggers capture relevant information and deliver structured payloads directly to your system, facilitating timely and context-aware responses.
<Frame caption="Triggers through Composio" background="subtle">
- ![Triggers Overview](../assets/images/triggers.png)
+ ![Triggers Overview](../../assets/images/triggers.png)
</Frame>
<Tip title="Prerequisites">
@@ -24,7 +24,7 @@ When these events take place, triggers capture relevant information and deliver
Head to the any app that supports triggers, eg [Slack](https://app.composio.dev/app/slack) in the dashboard and enable the trigger of choice.
<video
- src="../assets/videos/enabling-triggers.mp4"
+ src="../../assets/videos/enabling-triggers.mp4"
width="854"
height="480"
autoplay
@@ -36,7 +36,7 @@ Head to the any app that supports triggers, eg [Slack](https://app.composio.dev/
The [triggers page](https://app.composio.dev/active_triggers?page=1) will show you all the triggers that are enabled for your account.
<Frame caption="Triggers page" background="subtle">
- <img src="../assets/images/manage-triggers.png" alt="Manage triggers" />
+ <img src="../../assets/images/manage-triggers.png" alt="Manage triggers" />
</Frame>
You create triggers through the SDK as well.
@@ -122,7 +122,7 @@ print(instance)
To receive trigger events via webhooks, you need to configure a publicly accessible URL where Composio can send the event payloads. This URL should point to an endpoint in your application that can process incoming webhook requests.
<Frame caption="Webhook setup" background="subtle">
- <img src="../assets/images/setup-webhook.png" alt="Webhook setup" />
+ <img src="../../assets/images/setup-webhook.png" alt="Webhook setup" />
</Frame>
<CodeGroup>
@@ -203,7 +203,7 @@ The dashboard will show you the trigger configuration to fill in.
<Frame caption="Trigger configuration" background="subtle">
<img
- src="../assets/images/trigger-config.png"
+ src="../../assets/images/trigger-config.png"
alt="Trigger configuration"
width="400px"
height="auto"
@@ -281,5 +281,5 @@ If you encounter issues with triggers or webhook listeners, you can use the Comp
Access the trigger logs [here](https://app.composio.dev/trigger_logs).
<Frame caption="Trigger logs" background="subtle">
- <img src="../assets/images/trigger-debug.png" alt="Trigger logs" />
+ <img src="../../assets/images/trigger-debug.png" alt="Trigger logs" />
</Frame>
\ No newline at end of file
diff --git a/fern/scripts/build-snippets.ts b/fern/scripts/build-snippets.ts
index 5e64d488f..22b76d670 100644
--- a/fern/scripts/build-snippets.ts
+++ b/fern/scripts/build-snippets.ts
@@ -4,8 +4,9 @@
import fs, { watch } from 'fs';
import path from 'path';
-const DOCS_SRC_DIR = path.join(import.meta.dir, '../docs');
-const PAGES_DIR = path.join(import.meta.dir, '../pages');
+// Use default directories (no positional args for folder names)
+const DOCS_SRC_DIR = path.join(import.meta.dir, '../pages/src');
+const PAGES_DIST_DIR = path.join(import.meta.dir, '../pages/dist');
const PROJECT_ROOT = path.join(import.meta.dir, '../..');
interface SnippetCodeProps {
@@ -19,14 +20,10 @@ interface SnippetCodeProps {
}
function ensureDistDir() {
- // Remove existing pages directory to ensure clean build
- if (fs.existsSync(PAGES_DIR)) {
- fs.rmSync(PAGES_DIR, { recursive: true, force: true });
- console.log('🧹 Cleaned existing pages directory');
- }
+ // Remove existing dist directory to ensure clean build
- // Create fresh pages directory
- fs.mkdirSync(PAGES_DIR, { recursive: true });
+ // Create fresh dist directory
+ fs.mkdirSync(PAGES_DIST_DIR, { recursive: true });
}
function getLanguageFromPath(filePath: string): { syntax: string; displayName: string } {
@@ -167,7 +164,7 @@ function processFile(srcPath: string, distPath: string) {
fs.writeFileSync(distPath, processedContent);
console.log(
- `✅ Processed: ${path.relative(DOCS_SRC_DIR, srcPath)} -> ${path.relative(PAGES_DIR, distPath)}`
+ `✅ Processed: ${path.relative(DOCS_SRC_DIR, srcPath)} -> ${path.relative(PAGES_DIST_DIR, distPath)}`
);
} catch (error) {
console.error(`❌ Error processing ${srcPath}:`, error);
@@ -200,8 +197,8 @@ function processAllFiles() {
// If in SDK, preserve directory structure; otherwise flatten
const distPath = isInSDK
- ? path.join(PAGES_DIR, relativePath)
- : path.join(PAGES_DIR, entry.name);
+ ? path.join(PAGES_DIST_DIR, relativePath)
+ : path.join(PAGES_DIST_DIR, entry.name);
processFile(srcPath, distPath);
}
@@ -227,8 +224,8 @@ function startWatchMode() {
// If in SDK, preserve directory structure; otherwise flatten
const distPath = isInSDK
- ? path.join(PAGES_DIR, filename)
- : path.join(PAGES_DIR, path.basename(filename));
+ ? path.join(PAGES_DIST_DIR, filename)
+ : path.join(PAGES_DIST_DIR, path.basename(filename));
if (eventType === 'change' && fs.existsSync(srcPath)) {
console.log(`🔄 File changed: ${filename}`);
@@ -266,6 +263,8 @@ function startWatchMode() {
// Main function
function main() {
console.log('🚀 Starting SnippetCode processor...');
+ console.log(`Source: ${DOCS_SRC_DIR}`);
+ console.log(`Dist: ${PAGES_DIST_DIR}`);
ensureDistDir();
processAllFiles();
diff --git a/fern/typedoc.json b/fern/typedoc.json
index e693a6ae1..4945eb45c 100644
--- a/fern/typedoc.json
+++ b/fern/typedoc.json
@@ -1,6 +1,6 @@
{
"plugin": ["typedoc-plugin-zod", "typedoc-plugin-markdown"],
- "out": "./docs/sdk/typescript",
+ "out": "./pages/dist/sdk/typescript",
"fileExtension": ".mdx",
"flattenOutputFiles": false,
"useHTMLEncodedBrackets": false,