@dotenvx/dotenvx 2.4.0 → 2.4.1

package/CHANGELOG.md

@@ -2,7 +2,13 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.4.0...main)
+[Unreleased](https://github.com/dotenvx/dotenvx/compare/v2.4.1...main)
+
+## [2.4.1](https://github.com/dotenvx/dotenvx/compare/v2.4.0...v2.4.1) (2026-07-10)
+
+### Added
+
+* Support `config(path:)` as a directory like `app/web`. Useful for monorepos ([#882](https://github.com/dotenvx/dotenvx/pull/882))
 
 ## [2.4.0](https://github.com/dotenvx/dotenvx/compare/v2.3.4...v2.4.0) (2026-07-10)
 

package/README.md

@@ -2928,6 +2928,28 @@ You can also set `DOTENV_CONFIG_CONVENTION=nextjs`.
 $ DOTENV_CONFIG_CONVENTION=nextjs node index.js
 ```
 
+</details>
+<details><summary>`config(path: directory, convention: 'nextjs')` - directory</summary><br>
+
+Use a directory as `path` to make it the base for convention files. This is useful when loading a workspace's env files from a monorepo root.
+
+```js
+// index.js
+require('@dotenvx/dotenvx').config({
+  path: 'apps/web',
+  convention: 'nextjs'
+})
+```
+
+This loads the convention from `apps/web`:
+
+```text
+apps/web/.env.development.local
+apps/web/.env.local
+apps/web/.env.development
+apps/web/.env
+```
+
 </details>
 <details><summary>`config(noArmor:)` - noArmor</summary><br>
 

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.4.0",
+  "version": "2.4.1",
   "name": "@dotenvx/dotenvx",
   "description": "a secure dotenv–from the creator of `dotenv`",
   "author": "@motdotla",

package/src/lib/helpers/buildConfigEnvs.js

@@ -0,0 +1,13 @@
+const buildCommandEnvs = require('./buildCommandEnvs')
+const buildEnvs = require('./buildEnvs')
+
+function buildConfigEnvs (options = {}) {
+  if (options.envs) {
+    return options.envs
+  }
+
+  const pathOptions = { ...options, convention: undefined }
+  return buildCommandEnvs(buildEnvs(pathOptions), options.convention)
+}
+
+module.exports = buildConfigEnvs

package/src/lib/main.js

@@ -18,6 +18,7 @@ const setTransform = require('./transforms/set')
 
 // helpers
 const buildEnvs = require('./helpers/buildEnvs')
+const buildConfigEnvs = require('./helpers/buildConfigEnvs')
 const { determine } = require('./helpers/envResolution')
 const fsx = require('./helpers/fsx')
 const decryptKeyValue = require('./helpers/cryptography/decryptKeyValue')
@@ -69,7 +70,7 @@ const config = function (options = {}) {
   const noKeychain = resolveNoKeychain(options)
 
   try {
-    let envs = buildEnvs(options)
+    let envs = buildConfigEnvs(options)
     if (!options.envs) {
       envs = determine(envs, processEnv)
     }