motdotla/dotenv
50.3
Adequate · 15 November 2026
847
lines of production code
JavaScript
primary language
5
measurements over time
What this system is
Features
Added build and performance benchmark scripts
The project now includes a \scripts/build.js\ file that bundles the library using esbuild for Node 12+ and a \scripts/parse-perf.js\ script that benchmarks the new 'fast' parser against the classic and native implementations to ensure a minimum 1.5x speedup.
scripts · high confidence
New CLI for running commands with .env variables
Dotenv now includes a command-line interface (CLI) that allows you to run any command with environment variables loaded from a .env file. You can use \npx dotenv run -- node index.js\ to execute your application with the environment variables injected, or use the \--fast\ flag to opt-in to a faster character-scanner parser for improved performance on large files.
(repo-wide) · high confidence
New configuration options and Windows command spawning support
The library now supports configuring behavior via environment variables (DOTENV\CONFIG\\*) and introduces a new \fast\ parser option for improved performance. A new \config-options.js\ module handles parsing these environment variables, while \main.d.ts\ updates the TypeScript definitions to include the new \fast\, \override\, and \processEnv\ options. Additionally, a new \spawn-command.js\ module provides robust Windows command execution, handling argument quoting and shell protection for batch files and npm shims.
lib · high confidence
Test coverage
Added TypeScript type tests for dotenv API; Expanded test coverage for parsing, CLI, and configuration behavior; Removed legacy test suite for dotenv.load().
Dependencies
dotenv v18.0.5 release with modern build tooling and TypeScript support
The dotenv package has been updated to version 18.0.5, introducing a comprehensive rebuild of its development and distribution infrastructure. The build system now uses esbuild to compile output into the dist/ directory, replacing the previous lib/ structure. This change brings native TypeScript support, exposing type definitions via the new 'types' field and explicit 'exports' map for both the main module and the './config' entry point. The test suite has migrated from Mocha to Tap, and linting is handled by Standard. Additionally, the package now enforces a minimum Node.js version of 12 and includes a 'browser' field that disables the 'fs' module to prevent errors in browser environments.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 51 → 50 (-1.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 54 → 53 (-0.9)
- Architecture 69 → 69 (+0.0)
- Maturity 51 → 51 (+0.1)
- Readiness 42 → 44 (+1.2)
- Security 84 → 77 (-7.8)
Resolved (5)
- High CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- No ADRs found
- Off-boarding risk: anonymized user #1
- Repeated repair: tests/test-parse-fast.js (tests/test-parse-fast.js)
New (7)
- Medium CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- No ADRs found (package.json)
- Off-boarding risk: anonymized user #1
- redundant comment (lib/main.js)
Changes since last survey
- 13 commits — 7 feature/other, 6 fixes
By area
- (root) — 7 commits
- (repo) — 3 commits
- tests/test-cli.js — 2 commits
- lib/main.js — 1 commit
Notable commits
- fix: Merge pull request #1078 from NgoQuocViet2001/fix-cli-ignored-signal-hang
- fix: Merge pull request #1081 from wozhenbang2004/fix/cli-debug-stderr
- fix: fix(cli): exit when the command dies from SIGPIPE
- fix: fix(cli): keep library logging behavior
- fix: fix(cli): send debug diagnostics to stderr
- fix: npm audit fix
- change: 18.0.10
- change: Changelog
- change: Merge pull request #1082 from motdotla/dotenv-18-fe
- change: patch test
- change: remove debugOutput
- change: separate run to its own entry
- change: test(cli): keep child stdout clear with debug enabled
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
motdotla/dotenv was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 4c5450405612e4368e0d46d44da01942cf22a707 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.