From bcb809df8efc849c7cae4884eb025fbb77124b39 Mon Sep 17 00:00:00 2001
From: Charis <26616127+charislam@users.noreply.github.com>
Date: Mon, 22 Sep 2025 13:01:15 -0400
Subject: [PATCH] chore: add feature-flagged placeholder for CLI profiles
 (#38922)

- new feature flag: `docs:hide_cli_profiles`
- this must be implemented as a "negative" flag (hide instead of
  enable), because our current temporary hack for creating the Nimbus
  search index requires that the default state for all flags be true
---
 .../guides/local-development/cli/getting-started.mdx        | 6 ++++++
 packages/common/enabled-features/enabled-features.json      | 1 +
 .../common/enabled-features/enabled-features.schema.json    | 6 ++++++
 3 files changed, 13 insertions(+)

diff --git a/apps/docs/content/guides/local-development/cli/getting-started.mdx b/apps/docs/content/guides/local-development/cli/getting-started.mdx
index a65e54431e..2083fc8079 100644
--- a/apps/docs/content/guides/local-development/cli/getting-started.mdx
+++ b/apps/docs/content/guides/local-development/cli/getting-started.mdx
@@ -142,6 +142,12 @@ supabase stop --no-backup
 
 </Admonition>
 
+<$Show if="!docs:hide_cli_profiles">
+
+<Partial path="cli_profiles.mdx" />
+
+</$Show>
+
 ## Running Supabase locally
 
 The Supabase CLI uses Docker containers to manage the local development stack. Follow the official guide to install and configure [Docker Desktop](https://docs.docker.com/desktop):
diff --git a/packages/common/enabled-features/enabled-features.json b/packages/common/enabled-features/enabled-features.json
index 3221a0c981..931ba32102 100644
--- a/packages/common/enabled-features/enabled-features.json
+++ b/packages/common/enabled-features/enabled-features.json
@@ -40,6 +40,7 @@
   "docs:framework_quickstarts": true,
   "docs:full_getting_started": true,
   "docs:full_platform": true,
+  "docs:hide_cli_profiles": true,
   "docs:mobile_tutorials": true,
   "docs:pgtap": true,
   "docs:production_checklist": true,
diff --git a/packages/common/enabled-features/enabled-features.schema.json b/packages/common/enabled-features/enabled-features.schema.json
index cbb99e6bfb..354de556a9 100644
--- a/packages/common/enabled-features/enabled-features.schema.json
+++ b/packages/common/enabled-features/enabled-features.schema.json
@@ -115,6 +115,7 @@
       "type": "boolean",
       "description": "Enable the database roles page"
     },
+
     "docs:auth": {
       "type": "boolean",
       "description": "Enable auth docs"
@@ -143,6 +144,10 @@
       "type": "boolean",
       "description": "Enable full platform documentation"
     },
+    "docs:hide_cli_profiles": {
+      "type": "boolean",
+      "description": "Hide docs on CLI profiles"
+    },
     "docs:mobile_tutorials": {
       "type": "boolean",
       "description": "Enable mobile tutorials getting started documentation"
@@ -337,6 +342,7 @@
     "docs:framework_quickstarts",
     "docs:full_getting_started",
     "docs:full_platform",
+    "docs:hide_cli_profiles",
     "docs:mobile_tutorials",
     "docs:pgtap",
     "docs:production_checklist",