fix: remove env when no CLOUDFLARE_ENV set

RihanArfan · RihanArfan · commit 462b95481edd · 2025-12-17T15:32:01.000Z
diff --git a/docs/content/docs/1.getting-started/3.deploy.md b/docs/content/docs/1.getting-started/3.deploy.md
@@ -68,6 +68,48 @@ Then make sure to create the following `wrangler.jsonc` file in the root of your
 }
 ```
 
+### Environments
+
+Wrangler supports [environments](https://developers.cloudflare.com/workers/wrangler/environments/) to manage different configurations for staging, preview, or other deployment targets. You can define environment-specific bindings in your `wrangler.jsonc`:
+
+```jsonc [wrangler.jsonc]
+{
+  "$schema": "node_modules/wrangler/config-schema.json",
+  // Production bindings (top-level)
+  "d1_databases": [
+    {
+      "binding": "DB",
+      "database_id": "<production-database-id>"
+    }
+  ],
+  // Preview environment
+  "env": {
+    "preview": {
+      "d1_databases": [
+        {
+          "binding": "DB",
+          "database_id": "<preview-database-id>"
+        }
+      ]
+    }
+  }
+}
+```
+
+To deploy to a specific environment, set the `CLOUDFLARE_ENV` environment variable during build:
+
+```bash [Terminal]
+CLOUDFLARE_ENV=preview nuxt build
+```
+
+::note
+Bindings such as `d1_databases`, `kv_namespaces`, `r2_buckets`, and `vars` are non-inheritable and must be specified in each environment.
+::
+
+::callout{to="https://developers.cloudflare.com/workers/wrangler/environments/"}
+Learn more about Wrangler environments in the Cloudflare documentation.
+::
+
 ### Cache
 
 When self-hosting and using devtools for cache management (viewing/deleting cache entries), you need to configure additional environment variables:
diff --git a/src/hosting/cloudflare.ts b/src/hosting/cloudflare.ts
@@ -146,18 +146,18 @@ async function processWranglerConfigFile(nuxt: Nuxt, targetEnv?: string) {
     const content = await readFile(wranglerPath, 'utf-8')
     let config: WranglerConfigWithEnv = JSON.parse(content)
 
-    // Process environment if CLOUDFLARE_ENV is set
-    if (targetEnv) {
-      if (!config.env || !config.env[targetEnv]) {
-        log.info(`No environment "${targetEnv}" found in wrangler config, using top-level configuration`)
-        // Still remove the env section if it exists
-        if (config.env) {
-          const { env: _, ...rest } = config
-          config = rest
-        }
-      } else {
-        // Process the config to flatten the environment
-        config = processWranglerConfigEnv(config, targetEnv)
+    if (targetEnv && config.env?.[targetEnv]) {
+      // Flatten the specified environment into top-level config
+      config = processWranglerConfigEnv(config, targetEnv)
+      log.info(`Using wrangler environment \`${targetEnv}\``)
+    } else {
+      // Remove env section if present (use top-level config)
+      if (config.env) {
+        const { env: _, ...rest } = config
+        config = rest
+      }
+      if (targetEnv) {
+        log.info(`No environment \`${targetEnv}\` found in wrangler config, using top-level configuration`)
       }
     }
 
@@ -166,10 +166,6 @@ async function processWranglerConfigFile(nuxt: Nuxt, targetEnv?: string) {
 
     // Write the processed config back
     await writeFile(wranglerPath, JSON.stringify(config, null, 2), 'utf-8')
-
-    if (targetEnv) {
-      log.success(`Processed wrangler config for environment "${targetEnv}"`)
-    }
   } catch (error) {
     log.error(`Failed to process wrangler config: ${error}`)
   }
