Skip to content

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

feat(docs): update-ai-prompts (#40344)

Steven Eubank75d8d97e3380
diff --git a/apps/docs/content/guides/getting-started/ai-prompts.mdx b/apps/docs/content/guides/getting-started/ai-prompts.mdx
index 706a56033ba..fa2dd7bcfaf 100644
--- a/apps/docs/content/guides/getting-started/ai-prompts.mdx
+++ b/apps/docs/content/guides/getting-started/ai-prompts.mdx
@@ -14,3 +14,16 @@ Use the "include file" feature from your AI tool to include the prompt when chat
## Prompts
<AiPromptsIndex />
+
+## Use in different environments
+
+You can load these prompts into various tools. Here are common options and where to place the prompt:
+
+| Environment | Where to put prompt | Installation instructions |
+| -------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| Cursor | Project rules (`.cursor/rules/*.md` or `.mdx`) | [Configure project rules](https://docs.cursor.com/en/context/rules) |
+| GitHub Copilot | `.github/copilot-instructions.md` | [Custom instructions in Copilot](https://code.visualstudio.com/docs/copilot/copilot-customization#_custom-instructions) |
+| JetBrains IDEs | `guidelines.md` | [Customize guidelines](https://www.jetbrains.com/help/junie/customize-guidelines.html) |
+| Gemini CLI | `GEMINI.md` | [Gemini CLI codelab](https://codelabs.developers.google.com/gemini-cli-hands-on) |
+| VS Code | `.instructions.md` | Configure `.instructions.md` |
+| Windsurf | `guidelines.md` | Configure `guidelines.md` |
diff --git a/apps/docs/content/guides/getting-started/mcp.mdx b/apps/docs/content/guides/getting-started/mcp.mdx
index 60459e4947d..30addfc7514 100644
--- a/apps/docs/content/guides/getting-started/mcp.mdx
+++ b/apps/docs/content/guides/getting-started/mcp.mdx
@@ -28,6 +28,8 @@ After you log in, check that the MCP server is connected. For instance, in Curso
To verify the client has access to the MCP server tools, try asking it to query your project or database using natural language. For example: "What tables are there in the database? Use MCP tools."
+For curated, ready-to-use prompts that work well with IDEs and AI agents, see our [AI Prompts](/guides/getting-started/ai-prompts) collection.
+
## Manual authentication
By default the hosted Supabase MCP server uses [dynamic client registration](https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization#dynamic-client-registration) to authenticate with your Supabase org. This means that you don't need to manually create a personal access token (PAT) or OAuth app to use the server.
diff --git a/supa-mdx-lint/Rule003Spelling.toml b/supa-mdx-lint/Rule003Spelling.toml
index cf7fd76dada..9d0dc1857b1 100644
--- a/supa-mdx-lint/Rule003Spelling.toml
+++ b/supa-mdx-lint/Rule003Spelling.toml
@@ -164,6 +164,7 @@ allow_list = [
"ClickHouse",
"Clippy",
"Cloudflare",
+ "codelab",
"Codium",
"Cognito",
"Colab",
@@ -220,6 +221,7 @@ allow_list = [
"IntelliSense",
"IOWait",
"IVFFlat",
+ "JetBrains",
"JWTs",
"Jian",
"Jupyter",