From 1ed96746800fb2ed601d8c39c026ae02fcf2c77f Mon Sep 17 00:00:00 2001
From: Till Sanders <mail@till-sanders.de>
Date: Sat, 2 Nov 2024 22:41:09 +0100
Subject: [PATCH] docs: add information on `--envName` flag (#28909)

---
 docs/1.getting-started/3.configuration.md | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/docs/1.getting-started/3.configuration.md b/docs/1.getting-started/3.configuration.md
index 4cf9310b81..7be966f8c9 100644
--- a/docs/1.getting-started/3.configuration.md
+++ b/docs/1.getting-started/3.configuration.md
@@ -41,10 +41,17 @@ export default defineNuxtConfig({
   },
   $development: {
     //
-  }
+  },
+  $myCustomName: {
+    // 
+  },
 })
 ```
 
+To select an environment when running a Nuxt CLI command, simply pass the name to the `--envName` flag, like so: `nuxi build --envName myCustomName`.
+
+To learn more about the mechanism behind these overrides, please refer to the `c12` documentation on [environment-specific configuration](https://github.com/unjs/c12?tab=readme-ov-file#environment-specific-configuration).
+
 ::tip{icon="i-ph-video" to="https://www.youtube.com/watch?v=DFZI2iVCrNc" target="_blank"}
 Watch a video from Alexander Lichter about the env-aware `nuxt.config.ts`.
 ::