Skip to content

The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.

docs: move AI tools section (#45795)

Chris Chinchillaa93eef68483b
diff --git a/apps/docs/app/guides/ai-tools/[[...slug]]/page.tsx b/apps/docs/app/guides/ai-tools/[[...slug]]/page.tsx
new file mode 100644
index 00000000000..e23f1811e35
--- /dev/null
+++ b/apps/docs/app/guides/ai-tools/[[...slug]]/page.tsx
@@ -0,0 +1,26 @@
+import { GuideTemplate } from '~/features/docs/GuidesMdx.template'
+import {
+ genGuideMeta,
+ genGuidesStaticParams,
+ getGuidesMarkdown,
+} from '~/features/docs/GuidesMdx.utils'
+import { getEmptyArray } from '~/features/helpers.fn'
+import { IS_DEV } from '~/lib/constants'
+
+type Params = { slug?: string[] }
+
+const AiToolsGuidePage = async (props: { params: Promise<Params> }) => {
+ const params = await props.params
+ const slug = ['ai-tools', ...(params.slug ?? [])]
+ const data = await getGuidesMarkdown(slug)
+
+ return <GuideTemplate {...data!} />
+}
+
+const generateStaticParams = !IS_DEV ? genGuidesStaticParams('ai-tools') : getEmptyArray
+const generateMetadata = genGuideMeta((params: { slug?: string[] }) =>
+ getGuidesMarkdown(['ai-tools', ...(params.slug ?? [])])
+)
+
+export default AiToolsGuidePage
+export { generateMetadata, generateStaticParams }
diff --git a/apps/docs/app/guides/getting-started/ai-prompts/[slug]/page.tsx b/apps/docs/app/guides/ai-tools/ai-prompts/[slug]/page.tsx
similarity index 92%
rename from apps/docs/app/guides/getting-started/ai-prompts/[slug]/page.tsx
rename to apps/docs/app/guides/ai-tools/ai-prompts/[slug]/page.tsx
index 1213cb07a74..7eaf8f3ceae 100644
--- a/apps/docs/app/guides/getting-started/ai-prompts/[slug]/page.tsx
+++ b/apps/docs/app/guides/ai-tools/ai-prompts/[slug]/page.tsx
@@ -1,14 +1,13 @@
-import { GuideTemplate, newEditLink } from '~/features/docs/GuidesMdx.template'
-import { source } from 'common-tags'
-import { notFound } from 'next/navigation'
-
import {
generateAiPromptMetadata,
generateAiPromptsStaticParams,
generateCursorPromptDeepLink,
getAiPrompt,
wrapInMarkdownCodeBlock,
-} from './AiPrompts.utils'
+} from '~/app/guides/getting-started/ai-prompts/[slug]/AiPrompts.utils'
+import { GuideTemplate, newEditLink } from '~/features/docs/GuidesMdx.template'
+import { source } from 'common-tags'
+import { notFound } from 'next/navigation'
export const dynamicParams = false
@@ -51,7 +50,7 @@ export default async function AiPromptsPage(props: { params: Promise<{ slug: str
meta={{ title: `AI Prompt: ${heading}` }}
content={content}
editLink={newEditLink(`supabase/supabase/blob/master/examples/prompts/${slug}.md`)}
- pathname={`/guides/getting-started/ai-prompts/${slug}`}
+ pathname={`/guides/ai-tools/ai-prompts/${slug}`}
/>
)
}
diff --git a/apps/docs/app/guides/ai-tools/layout.tsx b/apps/docs/app/guides/ai-tools/layout.tsx
new file mode 100644
index 00000000000..187abe5919e
--- /dev/null
+++ b/apps/docs/app/guides/ai-tools/layout.tsx
@@ -0,0 +1,5 @@
+import Layout from '~/layouts/guides'
+
+export default async function AiToolsLayout({ children }: { children: React.ReactNode }) {
+ return <Layout>{children}</Layout>
+}
diff --git a/apps/docs/app/guides/ai-tools/troubleshooting/page.tsx b/apps/docs/app/guides/ai-tools/troubleshooting/page.tsx
new file mode 100644
index 00000000000..573b36fb795
--- /dev/null
+++ b/apps/docs/app/guides/ai-tools/troubleshooting/page.tsx
@@ -0,0 +1,15 @@
+import SectionTroubleshootingPage, {
+ generateSectionTroubleshootingMetadata,
+} from '~/features/docs/TroubleshootingSection.page'
+
+export default async function AiToolsTroubleshootingPage() {
+ return (
+ <SectionTroubleshootingPage
+ topic="ai-tools"
+ sectionName="AI Tools"
+ description="Search or browse troubleshooting guides for common AI tools issues, including configuration, usage, and integration problems."
+ />
+ )
+}
+
+export const metadata = generateSectionTroubleshootingMetadata('AI', 'AI Tools')
diff --git a/apps/docs/app/guides/getting-started/ai-prompts/[slug]/AiPromptsIndex.tsx b/apps/docs/app/guides/getting-started/ai-prompts/[slug]/AiPromptsIndex.tsx
index ed32afb8c67..6e6bf5b3053 100644
--- a/apps/docs/app/guides/getting-started/ai-prompts/[slug]/AiPromptsIndex.tsx
+++ b/apps/docs/app/guides/getting-started/ai-prompts/[slug]/AiPromptsIndex.tsx
@@ -1,5 +1,4 @@
import Link from 'next/link'
-
import { GlassPanel } from 'ui-patterns'
import { getAiPrompts } from './AiPrompts.utils'
@@ -12,7 +11,7 @@ export async function AiPromptsIndex() {
{prompts.map((prompt) => (
<Link
key={prompt.filename}
- href={`/guides/getting-started/ai-prompts/${prompt.filename}`}
+ href={`/guides/ai-tools/ai-prompts/${prompt.filename}`}
passHref
>
<GlassPanel
diff --git a/apps/docs/app/page.tsx b/apps/docs/app/page.tsx
index d4ba6201cb7..de63965fbd0 100644
--- a/apps/docs/app/page.tsx
+++ b/apps/docs/app/page.tsx
@@ -180,10 +180,16 @@ const clientLibraries = [
const additionalResources = [
{
- title: 'Management API',
- description: 'Manage your Supabase projects and organizations.',
- icon: 'reference-api',
- href: '/reference/api/introduction',
+ title: 'AI tools',
+ description: 'Develop with Supabase AI-first using plugins, MCP, and skills.',
+ icon: 'ai-tools',
+ href: '/guides/ai',
+ },
+ {
+ title: 'Platform guides',
+ description: 'Learn more about the tools and services powering Supabase.',
+ icon: 'platform',
+ href: '/guides/platform',
},
{
title: 'Supabase CLI',
@@ -192,10 +198,10 @@ const additionalResources = [
href: '/reference/cli/introduction',
},
{
- title: 'Platform Guides',
- description: 'Learn more about the tools and services powering Supabase.',
- icon: 'platform',
- href: '/guides/platform',
+ title: 'Management API',
+ description: 'Manage your Supabase projects and organizations.',
+ icon: 'reference-api',
+ href: '/reference/api/introduction',
},
{
title: 'Integrations',
diff --git a/apps/docs/components/HomePageCover.tsx b/apps/docs/components/HomePageCover.tsx
index 92ba17cb22d..706ce54ca8d 100644
--- a/apps/docs/components/HomePageCover.tsx
+++ b/apps/docs/components/HomePageCover.tsx
@@ -27,7 +27,7 @@ function AiPrompt({ className }: { className?: string }) {
'transition-colors',
className
)}
- href="/guides/getting-started/ai-prompts"
+ href="/guides/ai-tools/ai-prompts"
>
<Sparkles size={14} />
Start with Supabase AI prompts
diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
index 1da27c51790..26cfdc1186c 100644
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
@@ -58,6 +58,8 @@ const {
'sdk:swift',
])
+const aiToolsEnabled = true
+
const jsOnly =
!sdkCsharpEnabled && !sdkDartEnabled && !sdkKotlinEnabled && !sdkPythonEnabled && !sdkSwiftEnabled
@@ -148,6 +150,13 @@ export const GLOBAL_MENU_ITEMS: GlobalMenuItems = [
label: 'Build',
menuItems: [
[
+ {
+ label: 'AI Tools',
+ icon: 'ai-tools',
+ href: '/guides/ai-tools' as `/${string}`,
+ level: 'ai_tools',
+ enabled: aiToolsEnabled,
+ },
{
label: 'Local Development & CLI',
icon: 'dev-cli',
@@ -327,8 +336,9 @@ export const gettingstarted: NavMenuConstant = {
title: 'Start with Supabase',
url: '/guides/getting-started',
items: [
- { name: 'Features', url: '/guides/getting-started/features' },
+ { name: 'Build with AI tools', url: '/guides/ai-tools' },
{ name: 'API Keys', url: '/guides/getting-started/api-keys' },
+ { name: 'Local Development', url: '/guides/cli/getting-started' },
{ name: 'Architecture', url: '/guides/getting-started/architecture' },
{
name: 'Framework Quickstarts',
@@ -496,32 +506,6 @@ export const gettingstarted: NavMenuConstant = {
},
],
},
- {
- name: 'AI Tools',
- url: undefined,
- items: [
- {
- name: 'Supabase Plugin for AI Coding Agents',
- url: '/guides/getting-started/plugins' as `/${string}`,
- },
- {
- name: 'Prompts',
- url: '/guides/getting-started/ai-prompts' as `/${string}`,
- },
- {
- name: 'Agent Skills',
- url: '/guides/getting-started/ai-skills' as `/${string}`,
- },
- {
- name: 'Supabase MCP server',
- url: '/guides/getting-started/mcp' as `/${string}`,
- },
- {
- name: 'Deploy MCP servers',
- url: '/guides/getting-started/byo-mcp' as `/${string}`,
- },
- ],
- },
],
}
@@ -2307,6 +2291,47 @@ export const ai: NavMenuConstant = {
],
}
+export const ai_tools: NavMenuConstant = {
+ icon: 'ai-tools',
+ title: 'AI Tools',
+ url: '/guides/ai-tools',
+ enabled: aiToolsEnabled,
+ items: [
+ { name: 'Overview', url: '/guides/ai-tools' },
+ {
+ name: 'Agent Plugin',
+ url: '/guides/ai-tools/plugins' as `/${string}`,
+ },
+ {
+ name: 'MCP server',
+ url: '/guides/ai-tools/mcp' as `/${string}`,
+ },
+ {
+ name: 'Agent Skills',
+ url: '/guides/ai-tools/ai-skills' as `/${string}`,
+ },
+ {
+ name: 'Prompts',
+ url: '/guides/ai-tools/ai-prompts' as `/${string}`,
+ },
+
+ {
+ name: 'Build AI features',
+ url: undefined,
+ items: [
+ {
+ name: 'Deploy MCP servers',
+ url: '/guides/ai-tools/byo-mcp' as `/${string}`,
+ },
+ {
+ name: 'Vectors / Embeddings ',
+ url: '/guides/ai' as `/${string}`,
+ },
+ ],
+ },
+ ],
+}
+
export const local_development: NavMenuConstant = {
icon: 'dev-cli',
title: 'Local Dev / CLI',
diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.tsx b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.tsx
index 7e9056aad82..5b51b704c83 100644
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.tsx
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.tsx
@@ -24,6 +24,7 @@ enum MenuId {
Security = 'security',
SelfHosting = 'self_hosting',
Integrations = 'integrations',
+ AiTools = 'ai_tools',
LocalDevelopment = 'local_development',
Contributing = 'contributing',
RefJavaScriptV1 = 'reference_javascript_v1',
@@ -134,6 +135,10 @@ const menus: Menu[] = [
id: MenuId.LocalDevelopment,
type: 'guide',
},
+ {
+ id: MenuId.AiTools,
+ type: 'guide',
+ },
{
id: MenuId.Contributing,
type: 'guide',
diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.utils.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.utils.ts
index 4f50c7ee18c..556d87971a0 100644
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.utils.ts
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.utils.ts
@@ -110,7 +110,7 @@ export const getMenuId = (pathname: string | null) => {
pathname = (pathname ??= '').replace(/^\/guides\//, '')
switch (true) {
- case pathname.startsWith('ai'):
+ case pathname.startsWith('ai') && !pathname.startsWith('ai-tools'):
return MenuId.Ai
case pathname.startsWith('api'):
return MenuId.Api
@@ -132,6 +132,8 @@ export const getMenuId = (pathname: string | null) => {
return MenuId.Integrations
case pathname.startsWith('local-development'):
return MenuId.LocalDevelopment
+ case pathname.startsWith('ai-tools'):
+ return MenuId.AiTools
case pathname.startsWith('telemetry'):
return MenuId.Telemetry
case pathname.startsWith('platform'):
diff --git a/apps/docs/content/guides/ai-tools.mdx b/apps/docs/content/guides/ai-tools.mdx
new file mode 100644
index 00000000000..64ab99ea562
--- /dev/null
+++ b/apps/docs/content/guides/ai-tools.mdx
@@ -0,0 +1,19 @@
+---
+id: 'ai-tools'
+title: 'AI Tools'
+subtitle: 'Plugins, MCP, and skills for AI-first Supabase development.'
+---
+
+Supabase provides integrations and resources that your AI coding agents can use to build on Supabase:
+
+- [Agent Plugin](/docs/guides/ai-tools/plugins): One-click setup that bundles the MCP server and agent skills into a single install for your AI coding agent.
+- [MCP Server](/docs/guides/ai-tools/mcp): Connect your AI agent to your Supabase project using the Model Context Protocol (MCP). Gives your agent tools to read your schema, run queries, manage migrations, and more - directly from your IDE.
+- [Agent Skills](/docs/guides/ai-tools/ai-skills): Curated instruction sets that give your AI agent procedural knowledge about working with Supabase.
+- [Prompts](/docs/guides/ai-tools/ai-prompts): Ready-to-use prompts for common Supabase tasks. Copy them into your project and reference them from your AI tool for consistent, accurate output.
+
+## Building AI into your app?
+
+The tools above are for your development workflow. If you're building AI capabilities into your own product:
+
+- [Deploy MCP servers](/docs/guides/ai-tools/byo-mcp) - Host your own MCP server on Supabase Edge Functions so your users can connect their AI agents to your product
+- [Vectors / Embeddings](/docs/guides/ai) - Build semantic search, RAG pipelines, and other AI-powered features using pgvector
diff --git a/apps/docs/content/guides/getting-started/ai-prompts.mdx b/apps/docs/content/guides/ai-tools/ai-prompts.mdx
similarity index 100%
rename from apps/docs/content/guides/getting-started/ai-prompts.mdx
rename to apps/docs/content/guides/ai-tools/ai-prompts.mdx
diff --git a/apps/docs/content/guides/getting-started/ai-skills.mdx b/apps/docs/content/guides/ai-tools/ai-skills.mdx
similarity index 100%
rename from apps/docs/content/guides/getting-started/ai-skills.mdx
rename to apps/docs/content/guides/ai-tools/ai-skills.mdx
diff --git a/apps/docs/content/guides/getting-started/byo-mcp.mdx b/apps/docs/content/guides/ai-tools/byo-mcp.mdx
similarity index 100%
rename from apps/docs/content/guides/getting-started/byo-mcp.mdx
rename to apps/docs/content/guides/ai-tools/byo-mcp.mdx
diff --git a/apps/docs/content/guides/getting-started/mcp.mdx b/apps/docs/content/guides/ai-tools/mcp.mdx
similarity index 99%
rename from apps/docs/content/guides/getting-started/mcp.mdx
rename to apps/docs/content/guides/ai-tools/mcp.mdx
index 3996ea5f5d5..9379f4fb1dd 100644
--- a/apps/docs/content/guides/getting-started/mcp.mdx
+++ b/apps/docs/content/guides/ai-tools/mcp.mdx
@@ -1,9 +1,9 @@
---
id: 'ai-tools-mcp'
-title: 'Model context protocol (MCP)'
+title: 'Supabase MCP Server'
subtitle: 'Connect your AI tools to Supabase using MCP'
description: 'Connect your AI tools to Supabase using MCP'
-sidebar_label: 'Model context protocol (MCP)'
+sidebar_label: 'MCP Server'
---
The [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) is a standard for connecting Large Language Models (LLMs) to platforms like Supabase. Once connected, your AI assistants can interact with and query your Supabase projects on your behalf.
diff --git a/apps/docs/content/guides/getting-started/plugins.mdx b/apps/docs/content/guides/ai-tools/plugins.mdx
similarity index 100%
rename from apps/docs/content/guides/getting-started/plugins.mdx
rename to apps/docs/content/guides/ai-tools/plugins.mdx
diff --git a/apps/docs/content/guides/getting-started.mdx b/apps/docs/content/guides/getting-started.mdx
index 3509c2a3c9a..45807648272 100644
--- a/apps/docs/content/guides/getting-started.mdx
+++ b/apps/docs/content/guides/getting-started.mdx
@@ -11,17 +11,17 @@ hideToc: true
<div className="grid grid-cols-12 gap-6 not-prose">
{[
- {
- title: 'Features',
+ {
+ title: 'Build with AI tools',
+ description: 'Develop with Supabase AI-first using plugins, MCP, and skills.',
hasLightIcon: true,
- href: '/guides/getting-started/features',
- description: 'A non-exhaustive list of features that Supabase provides for every project.'
- },
- {
- title: 'Architecture',
+ href: '/guides/ai',
+ },
+ {
+ title: 'API Keys',
hasLightIcon: true,
- href: '/guides/getting-started/architecture',
- description: "An overview of Supabase's architecture and product principles.",
+ href: '/guides/getting-started/api-keys',
+ description: 'Learn about the different API keys in Supabase and how to use them.',
},
{
title: 'Local Development',
diff --git a/apps/docs/features/docs/NavigationPageStatus.utils.ts b/apps/docs/features/docs/NavigationPageStatus.utils.ts
index 6968e1e23aa..f8e10c42c84 100644
--- a/apps/docs/features/docs/NavigationPageStatus.utils.ts
+++ b/apps/docs/features/docs/NavigationPageStatus.utils.ts
@@ -1,7 +1,7 @@
import { type NavMenuConstant } from '~/components/Navigation/Navigation.types'
import {
- GLOBAL_MENU_ITEMS,
ai,
+ ai_tools,
api,
auth,
cron,
@@ -9,6 +9,7 @@ import {
deployment,
functions,
gettingstarted,
+ GLOBAL_MENU_ITEMS,
graphql,
integrations,
local_development,
@@ -33,6 +34,7 @@ const SECTION_NAV_MAPS: Record<string, NavMenuConstant> = {
'getting-started': gettingstarted,
graphql,
integrations,
+ 'ai-tools': ai_tools,
'local-development': local_development,
platform,
queues,
diff --git a/apps/docs/features/docs/Troubleshooting.utils.common.mjs b/apps/docs/features/docs/Troubleshooting.utils.common.mjs
index 8984b753282..c938dced206 100644
--- a/apps/docs/features/docs/Troubleshooting.utils.common.mjs
+++ b/apps/docs/features/docs/Troubleshooting.utils.common.mjs
@@ -60,6 +60,7 @@ export const TroubleshootingSchema = z
topics: z.array(
z.enum([
'ai',
+ 'ai-tools',
'auth',
'branching',
'cli',
diff --git a/apps/www/lib/redirects.js b/apps/www/lib/redirects.js
index 80ba16dcfe9..74cd36db7ef 100644
--- a/apps/www/lib/redirects.js
+++ b/apps/www/lib/redirects.js
@@ -3099,6 +3099,42 @@ module.exports = [
destination: '/docs/guides/database/overview',
},
+ // AI tools move
+ {
+ permanent: true,
+ source: '/docs/guides/getting-started/plugins',
+ destination: '/docs/guides/ai-tools/plugins',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/getting-started/ai-prompts',
+ destination: '/docs/guides/ai-tools/ai-prompts',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/getting-started/ai-prompts',
+ destination: '/docs/guides/ai-tools/ai-prompts',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/getting-started/ai-prompts/:slug',
+ destination: '/docs/guides/ai-tools/ai-prompts/:slug',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/getting-started/ai-skills',
+ destination: '/docs/guides/ai-tools/ai-skills',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/getting-started/mcp',
+ destination: '/docs/guides/ai-tools/mcp',
+ },
+ {
+ permanent: true,
+ source: '/docs/guides/getting-started/byo-mcp',
+ destination: '/docs/guides/ai-tools/byo-mcp',
+ },
// design
{
permanent: true,