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.

docs: change urls for toolkits

[email protected]07323ad5a089
diff --git a/.gitignore b/.gitignore
index cab0e30da..86b226e54 100644
--- a/.gitignore
+++ b/.gitignore
@@ -41,6 +41,9 @@ lerna-debug.log*
# fern
fern/tools/*
+fern/toolkits/*
+!fern/toolkits/src/
+!fern/toolkits/src/**
!fern/tools/src/
!fern/tools/src/**
fern/apis/openapi.yml
diff --git a/fern/docs.yml b/fern/docs.yml
index 103fca0f3..2070e76f8 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -62,6 +62,9 @@ colors:
analytics:
posthog:
api-key: ${POSTHOG_API_KEY}
+redirects:
+- source: /tools/*
+ destination: /toolkits/*
tabs:
docs:
display-name: Guides
@@ -74,8 +77,8 @@ tabs:
display-name: API Reference
icon: server
skip-slug: true
- tools:
- display-name: Tools
+ toolkits:
+ display-name: Toolkits
icon: tools
skip-slug: true
providers:
@@ -241,38 +244,41 @@ navigation:
- page: Python
path: pages/dist/providers/py-custom.mdx
slug: providers/custom/python
-- tab: tools
+- tab: toolkits
layout:
- - section: Tool
+ - section: Toolkits
+ skip-slug: true
contents:
- page: Introduction
- path: tools/introduction.mdx
+ path: toolkits/src/introduction.mdx
+ slug: toolkits/introduction
- page: Premium Tools
- path: tools/src/premium-tools.mdx
+ path: toolkits/src/premium-tools.mdx
+ slug: toolkits/premium-tools
- section: Important
skip-slug: true
contents:
- page: Github
- slug: tools/github
- path: tools/github.mdx
+ slug: toolkits/github
+ path: toolkits/github.mdx
- page: Gmail
- slug: tools/gmail
- path: tools/gmail.mdx
+ slug: toolkits/gmail
+ path: toolkits/gmail.mdx
- page: Notion
- slug: tools/notion
- path: tools/notion.mdx
+ slug: toolkits/notion
+ path: toolkits/notion.mdx
- section: Scheduling & Booking
skip-slug: true
contents:
- page: Googlecalendar
- slug: tools/googlecalendar
- path: tools/googlecalendar.mdx
+ slug: toolkits/googlecalendar
+ path: toolkits/googlecalendar.mdx
- section: No Auth
skip-slug: true
contents:
- page: Composio
- slug: tools/composio
- path: tools/composio.mdx
+ slug: toolkits/composio
+ path: toolkits/composio.mdx
- tab: sdk-reference
layout:
- section: Python
diff --git a/fern/generators/tool_doc_generator/base_docs.py b/fern/generators/tool_doc_generator/base_docs.py
index 6e7bea13f..408ddb5fc 100644
--- a/fern/generators/tool_doc_generator/base_docs.py
+++ b/fern/generators/tool_doc_generator/base_docs.py
@@ -1,14 +1,17 @@
base_layout = [
{
- "section": "Tool",
+ "section": "Toolkits",
+ "skip-slug": True,
"contents": [
{
"page": "Introduction",
- "path": "tools/introduction.mdx"
+ "path": "toolkits/src/introduction.mdx",
+ "slug": "toolkits/introduction"
},
{
"page": "Premium Tools",
- "path": "tools/src/premium-tools.mdx"
+ "path": "toolkits/src/premium-tools.mdx",
+ "slug": "toolkits/premium-tools"
}
]
}
diff --git a/fern/generators/tool_doc_generator/main.py b/fern/generators/tool_doc_generator/main.py
index a6ad8eb98..ab4a52dfb 100644
--- a/fern/generators/tool_doc_generator/main.py
+++ b/fern/generators/tool_doc_generator/main.py
@@ -234,13 +234,13 @@ Use the dashboard to create an auth config for the {app_name} toolkit. This allo
<Steps>
<Step title="Select App">
- Navigate to the [{app_name} toolkit page](https://app.composio.dev/apps/{app_name}) and click **"Setup Integration"**.
+ Navigate to [platform.composio.dev](https://platform.composio.dev), click **"All Toolkits" and head to the {app_name}**.
</Step>
<Step title="Configure Auth Config Settings">
Select among the supported auth schemes of and configure them here.
</Step>
<Step title="Create and Get auth config ID">
- Click **"Create Integration"**. After creation, **copy the displayed ID starting with `ac_`**. This is your auth config ID. This is _not_ a sensitive ID -- you can save it in environment variables or a database.
+ Click **"Create {app_name} Auth Config"**. After creation, **copy the displayed ID starting with `ac_`**. This is your auth config ID. This is _not_ a sensitive ID -- you can save it in environment variables or a database.
**This ID will be used to create connections to the toolkit for a given user.**
</Step>
</Steps>
@@ -782,7 +782,7 @@ class ToolDocGenerator:
{
"name": toolkit.slug.lower(),
"display_name": titleize(toolkit.name.lower()),
- "path": f"tools/{filename}",
+ "path": f"toolkits/{filename}",
"category": category,
"tool_count": len(tools),
"no_auth": no_auth,
@@ -817,7 +817,7 @@ class ToolDocGenerator:
for tool in sorted_tools:
entry = {
"page": tool["display_name"],
- "slug": "tools/" + tool["name"],
+ "slug": "toolkits/" + tool["name"],
"path": tool["path"],
}
name = tool["name"]
@@ -956,7 +956,7 @@ def cli_main() -> int:
"-o",
type=str,
help="Path for documentation output (default: ./tools)",
- default="./tools",
+ default="./toolkits",
)
parser.add_argument(
"--include-local",
diff --git a/fern/toolkits/src/introduction.mdx b/fern/toolkits/src/introduction.mdx
new file mode 100644
index 000000000..6c716c46a
--- /dev/null
+++ b/fern/toolkits/src/introduction.mdx
@@ -0,0 +1,37 @@
+---
+title: Introduction to Tools
+---
+
+Tools are the building blocks of Composio. They are used to interact with external APIs and services.
+
+Composio comes with support for 250+ apps with built in authentication and actions.
+
+<CardGroup>
+<Card title="Twitter Tool" href="/toolkits/twitter" icon="fa-brands fa-x-twitter">
+View the authentication and actions for the Twitter tool.
+</Card>
+
+<Card title="Gmail Tool" href="/toolkits/gmail" icon="fa-solid fa-envelope">
+ View the authentication and actions for the Gmail tool.
+</Card>
+
+<Card title="Github Tool" href="/toolkits/github" icon="fa-brands fa-github">
+ View the authentication and actions for the Github tool.
+</Card>
+
+<Card title="Notion Tool" href="/toolkits/notion" icon="fa-solid fa-book">
+ View the authentication and actions for the Notion tool.
+</Card>
+
+<Card title="Google Sheets Tool" href="/toolkits/googlesheets" icon="fa-solid fa-file-spreadsheet">
+ View the authentication and actions for the Google Sheets tool.
+</Card>
+
+<Card title="Shopify Tool" href="/toolkits/shopify" icon="fa-brands fa-shopify">
+ View the authentication and actions for the Shopify tool.
+</Card>
+
+<Card title="Stripe Tool" href="/toolkits/stripe" icon="fa-brands fa-stripe">
+View the authentication and actions for the Stripe tool.
+</Card>
+</CardGroup>
diff --git a/fern/tools/src/premium-tools.mdx b/fern/toolkits/src/premium-tools.mdx
similarity index 100%
rename from fern/tools/src/premium-tools.mdx
rename to fern/toolkits/src/premium-tools.mdx