feat(nuxi): support --dotenv for dev, build and preview commands (#7660)

Author: cpreston321

docs/content/3.api/5.commands/build.md

@@ -1,14 +1,15 @@
 # `nuxi build`
 
 ```{bash}
-npx nuxi build [rootDir]
+npx nuxi build [rootDir] [--prerender] [--dotenv]
 ```
 
 The `build` command creates a `.output` directory with all your application, server and dependencies ready for production.
 
 Option        | Default          | Description
 -------------------------|-----------------|------------------
 `rootDir` | `.` | The root directory of the application to bundle.
-`prerender` | `false` | Pre-render every route of your application. (**note:** This is an experimental flag. The behavior might be changed.)
+`--prerender` | `false` | Pre-render every route of your application. (**note:** This is an experimental flag. The behavior might be changed.)
+`--dotenv` | `.` | Point to another `.env` file to load, **relative** to the root directory.
 
 This command sets `process.env.NODE_ENV` to `production`.

docs/content/3.api/5.commands/dev.md

@@ -1,14 +1,15 @@
 # `nuxi dev`
 
 ```{bash}
-npx nuxi dev [rootDir] [--clipboard] [--open, -o] [--no-clear] [--port, -p] [--host, -h] [--https] [--ssl-cert] [--ssl-key]
+npx nuxi dev [rootDir] [--dotenv] [--clipboard] [--open, -o] [--no-clear] [--port, -p] [--host, -h] [--https] [--ssl-cert] [--ssl-key]
 ```
 
 The `dev` command starts a development server with hot module replacement at [http://localhost:3000](https://localhost:3000)
 
 Option        | Default          | Description
 -------------------------|-----------------|------------------
 `rootDir` | `.` | The root directory of the application to serve.
+`--dotenv` | `.` | Point to another `.env` file to load, **relative** to the root directory.
 `--clipboard` | `false` | Copy URL to clipboard.
 `--open, -o` | `false` | Open URL in browser.
 `--no-clear` | `false` | Does not clear the console after startup.

docs/content/3.api/5.commands/preview.md

@@ -1,14 +1,15 @@
 # `nuxi preview`
 
 ```{bash}
-npx nuxi preview [rootDir]
+npx nuxi preview [rootDir] [--dotenv]
 ```
 
 The `preview` command starts a server to preview your Nuxt application after running the `build` command.
 
 Option        | Default          | Description
 -------------------------|-----------------|------------------
 `rootDir` | `.` | The root directory of the application to preview.
+`--dotenv` | `.` | Point to another `.env` file to load, **relative** to the root directory.
 
 This command sets `process.env.NODE_ENV` to `production`. To override, define `NODE_ENV` in a `.env` file or as command-line argument.
 

packages/nuxi/src/commands/build.ts

@@ -10,7 +10,7 @@ import { defineNuxtCommand } from './index'
 export default defineNuxtCommand({
   meta: {
     name: 'build',
-    usage: 'npx nuxi build [--prerender] [rootDir]',
+    usage: 'npx nuxi build [--prerender] [--dotenv] [rootDir]',
     description: 'Build nuxt for production deployment'
   },
   async invoke (args) {
@@ -23,6 +23,10 @@ export default defineNuxtCommand({
 
     const nuxt = await loadNuxt({
       rootDir,
+      dotenv: {
+        cwd: rootDir,
+        fileName: args.dotenv
+      },
       overrides: {
         _generate: args.prerender
       }

packages/nuxi/src/commands/dev.ts

@@ -18,7 +18,7 @@ import { defineNuxtCommand } from './index'
 export default defineNuxtCommand({
   meta: {
     name: 'dev',
-    usage: 'npx nuxi dev [rootDir] [--clipboard] [--open, -o] [--port, -p] [--host, -h] [--https] [--ssl-cert] [--ssl-key]',
+    usage: 'npx nuxi dev [rootDir] [--dotenv] [--clipboard] [--open, -o] [--port, -p] [--host, -h] [--https] [--ssl-cert] [--ssl-key]',
     description: 'Run nuxt development server'
   },
   async invoke (args) {
@@ -40,7 +40,7 @@ export default defineNuxtCommand({
     const rootDir = resolve(args._[0] || '.')
     showVersions(rootDir)
 
-    await setupDotenv({ cwd: rootDir })
+    await setupDotenv({ cwd: rootDir, fileName: args.dotenv })
 
     const listener = await listen(serverHandler, {
       showURL: false,

packages/nuxi/src/commands/preview.ts

@@ -10,7 +10,7 @@ import { defineNuxtCommand } from './index'
 export default defineNuxtCommand({
   meta: {
     name: 'preview',
-    usage: 'npx nuxi preview|start [rootDir]',
+    usage: 'npx nuxi preview|start [--dotenv] [rootDir]',
     description: 'Launches nitro server for local testing after `nuxi build`.'
   },
   async invoke (args) {
@@ -35,9 +35,10 @@ export default defineNuxtCommand({
       process.exit(1)
     }
 
-    if (existsSync(resolve(rootDir, '.env'))) {
+    const envExists = args.dotenv ? existsSync(resolve(rootDir, args.dotenv)) : existsSync(rootDir)
+    if (envExists) {
       consola.info('Loading `.env`. This will not be loaded when running the server in production.')
-      await setupDotenv({ cwd: rootDir })
+      await setupDotenv({ cwd: rootDir, fileName: args.dotenv })
     }
 
     consola.info('Starting preview command:', nitroJSON.commands.preview)