The Postgres development platform. Supabase gives you a dedicated Postgres database to build your web, mobile, and AI applications.
TypeScript aialternativeauthdatabasedenoembeddingsexamplefirebasenextjsoauth2pgvectorpostgispostgrespostgresqlpostgrestrealtimesupabasevectorswebsockets
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.tsxnew file mode 100644index 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.tsxsimilarity index 92%rename from apps/docs/app/guides/getting-started/ai-prompts/[slug]/page.tsxrename to apps/docs/app/guides/ai-tools/ai-prompts/[slug]/page.tsxindex 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: strmeta={{ 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.tsxnew file mode 100644index 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.tsxnew file mode 100644index 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.tsxindex 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) => (<Linkkey={prompt.filename}- href={`/guides/getting-started/ai-prompts/${prompt.filename}`}+ href={`/guides/ai-tools/ai-prompts/${prompt.filename}`}passHref><GlassPaneldiff --git a/apps/docs/app/page.tsx b/apps/docs/app/page.tsxindex 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.tsxindex 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 promptsdiff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.tsindex 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.tsxindex 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.tsindex 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.Aicase pathname.startsWith('api'):return MenuId.Api@@ -132,6 +132,8 @@ export const getMenuId = (pathname: string | null) => {return MenuId.Integrationscase pathname.startsWith('local-development'):return MenuId.LocalDevelopment+ case pathname.startsWith('ai-tools'):+ return MenuId.AiToolscase pathname.startsWith('telemetry'):return MenuId.Telemetrycase pathname.startsWith('platform'):diff --git a/apps/docs/content/guides/ai-tools.mdx b/apps/docs/content/guides/ai-tools.mdxnew file mode 100644index 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 pgvectordiff --git a/apps/docs/content/guides/getting-started/ai-prompts.mdx b/apps/docs/content/guides/ai-tools/ai-prompts.mdxsimilarity index 100%rename from apps/docs/content/guides/getting-started/ai-prompts.mdxrename to apps/docs/content/guides/ai-tools/ai-prompts.mdxdiff --git a/apps/docs/content/guides/getting-started/ai-skills.mdx b/apps/docs/content/guides/ai-tools/ai-skills.mdxsimilarity index 100%rename from apps/docs/content/guides/getting-started/ai-skills.mdxrename to apps/docs/content/guides/ai-tools/ai-skills.mdxdiff --git a/apps/docs/content/guides/getting-started/byo-mcp.mdx b/apps/docs/content/guides/ai-tools/byo-mcp.mdxsimilarity index 100%rename from apps/docs/content/guides/getting-started/byo-mcp.mdxrename to apps/docs/content/guides/ai-tools/byo-mcp.mdxdiff --git a/apps/docs/content/guides/getting-started/mcp.mdx b/apps/docs/content/guides/ai-tools/mcp.mdxsimilarity index 99%rename from apps/docs/content/guides/getting-started/mcp.mdxrename to apps/docs/content/guides/ai-tools/mcp.mdxindex 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.mdxsimilarity index 100%rename from apps/docs/content/guides/getting-started/plugins.mdxrename to apps/docs/content/guides/ai-tools/plugins.mdxdiff --git a/apps/docs/content/guides/getting-started.mdx b/apps/docs/content/guides/getting-started.mdxindex 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.tsindex 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.mjsindex 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 = ztopics: z.array(z.enum(['ai',+ 'ai-tools','auth','branching','cli',diff --git a/apps/www/lib/redirects.js b/apps/www/lib/redirects.jsindex 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,