PackageTrack

npm · #3608

@dotenvx/dotenvx

2.21.0dotenvx/dotenvx

a secure dotenv–from the creator of `dotenv`

Release timeline

338 releases since 2023
202420252026

Releases

  1. 1.47.39 Jul 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Send to radar#observe if Radar installed by user (#631)

    Removed

    • Remove cli in package.json (#632)
    Open source →
  2. 1.47.29 Jul 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Export cli in package.json (#629)
    Open source →
  3. 1.47.19 Jul 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add convenience log that radar active 📡 when dotenvx-radar is installed (#625)
    Open source →
  4. 1.47.08 Jul 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add optional dotenvx radar command (#624)
    • Radar is an early access commercial extension for dotenvx that will auto backup your .env files.
     _______________________________________________________________________
    |                                                                       |
    |  Dotenvx Radar: Env Observability                                     |
    |                                                                       |
    |  ░▒▓███████▓▒░ ░▒▓██████▓▒░░▒▓███████▓▒░ ░▒▓██████▓▒░░▒▓███████▓▒░    |
    |  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
    |  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
    |  ░▒▓███████▓▒░░▒▓████████▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓████████▓▒░▒▓███████▓▒░    |
    |  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
    |  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
    |  ░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓███████▓▒░░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░   |
    |                                                                       |
    |  Observe, version, and back up your environment variables at runtime. |
    |                                                                       |
    |  Purchase lifetime access at https://dotenvx.com/radar                |
    |                                                                       |
    | --------------------------------------------------------------------- |
    | - thank you for using dotenvx! - @motdotla                            |
    |_______________________________________________________________________|
    
    Open source →
  5. 1.46.07 Jul 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add error when hoisting issue experienced around commander.js (#623)

    Removed

    • Remove git-dotenvx and git dotenvx shorthand (#621)
    Open source →
  6. 1.45.22 Jul 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Minor README updates
    Open source →
  7. 1.45.120 Jun 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Include setLogName and setLogVersion in config (#613)
    Open source →
  8. 1.45.020 Jun 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add logger.setName and logger.setVersion for customization of logger (#612)
    Open source →
  9. 1.44.211 Jun 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Clarify license is BSD-3.
    Open source →
  10. 1.44.119 May 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Patch SetOutput type (#597)
    Open source →
  11. 1.44.012 May 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add armv7 support (#593)
    Open source →
  12. 1.43.04 May 2025
    Release notesOpen source →
    Release notes2 sources agree

    Removed

    • Remove errorv, errornocolor, blank from logger options (#584)

    Changed

    • Replace instances of console.error with logger.error (#584)
    Open source →
  13. 1.42.22 May 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Fix --force flag work with ?force=true (2776715)
    Open source →
  14. 1.42.12 May 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add --force flag to install.sh (0b8d21c)
    Open source →
  15. 1.42.030 Apr 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add ability to override the os and arch via install.sh and dotenvx.sh (3ded752)
    Open source →
  16. 1.41.018 Apr 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add [directory] argument to precommit and prebuild (#572)
    Open source →
  17. 1.40.117 Apr 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Patch ext scan command (#570)
    Open source →
  18. 1.40.013 Apr 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Smarter ext precommit and ext prebuild – catch duplicate KEYs in the same .env file where one is mistakenly left unencrypted (#567)
    Open source →
  19. 1.39.14 Apr 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add version to homebrew formula (#564)
    Open source →
  20. 1.39.016 Mar 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add --convention flow option to dotenvx run (#551)

    Changed

    Open source →
  21. 1.38.512 Mar 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • 🐞 Add config.d.ts file to fix type error when loading dotenvx/dotenvx/config with dynamic import (#547)
    Open source →
  22. 1.38.44 Mar 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • 🐞 Fix blank line disappearing after encrypting empty value (#542)
    Open source →
  23. 1.38.325 Feb 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • 🐞 Fix self-referencing expansion when key exists already in process.env (#536)
    Open source →
  24. 1.38.224 Feb 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • Add typescript types for main.get.
    Open source →
  25. 1.38.124 Feb 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Support encrypt when mutliline contains windows CRLF (\r\n) (#534)

    Note: dotenvx will convert these \r\n newlines to \n. Our recommendation is to stop using CRLF - its origin is from typewriter days. Instead, set your editor or gitattributes to use LF.

    Open source →
  26. 1.38.024 Feb 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • Command substitution failures no longer halt further processing of keys in a .env file (#533)
    • A more helpful error is raised if a command substitution failure occurs (#533)
    Open source →
  27. 1.37.021 Feb 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add dotenvx rotate command 🎉 (#530)

    also: our whitepaper is released as a draft.

    Open source →
  28. 1.36.012 Feb 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • --strict flag respects (doesn't throw) anything in --ignore flag (#527)
    Open source →
  29. 1.35.07 Feb 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • npx dotenvx precommit support as a convenience (#523)
    • main.get method (#524)

    The addition of main.get facilitates what we term Decryption at Access, a concept explored in greater detail in our whitepaper.

    Open source →
  30. 1.34.025 Jan 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • main.set method now writes to files (#517)
    Open source →
  31. 1.33.013 Jan 2025
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • support ESM import convenience import '@dotenvx/dotenvx/config' (#508)
    Open source →
  32. 1.32.18 Jan 2025
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • remove duplicated help messages (#504)
    Open source →
  33. 1.32.027 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add encrypted check support for ext prebuild (#501)

    Changed

    • modify ext precommit to check git modified state as well as git staged state - useful for using dotenvx ext precommit without the --install flag in automated scripts and ci. (#499)

    Removed

    • remove internal logger methods errorvp, errorvpb, warnv, warnvp, warnvpb, successvp, successvpb, help2 (#501)
    Open source →
  34. 1.31.320 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • adjust wingetcreate to use powershell when parsing version
    Open source →
  35. 1.31.220 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • use wingetcreate for releasing to WinGet (#498)
    Open source →
  36. 1.31.120 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • 🐞 fix encryption of values containing explicit \n newlines (#495)
    Open source →
  37. 1.31.014 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • expose main.set function (#492)
    • add missing types for main.config (#491)
    Open source →
  38. 1.30.114 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • support complex command substitution combining variable expansion (#490)
    Open source →
  39. 1.30.014 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add -fk (--env-keys-file) flag to customize the path to your .env.keys file with run, get, set, encrypt, decrypt, and keypair 🎉 (#486)

    This is great for monorepos. Maintain one .env.keys file across all your apps.

    $ dotenvx encrypt -fk .env.keys -f apps/backend/.env
    $ dotenvx encrypt -fk .env.keys -f apps/frontend/.env
    
    $ tree -a .
    ├── .env.keys
    └── apps
        ├── backend
        │   └── .env
        └── frontend
            └── .env
    
    $ dotenvx get -fk .env.keys -f apps/backend/.env
    
    Open source →
  40. 1.29.09 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add --ignore flag to suppress specified errors. example: dotenvx run --ignore=MISSING_ENV_FILE (#485)
    Open source →
  41. 1.28.03 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • .env.keys file is generated WITHOUT quotes going forward. This is to minimize friction around Docker gotchas to developers - old versions of Docker do not support --env-file containing quoted keys/values. (#480) (additional note)
    Open source →
  42. 1.27.03 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add support for \t expansion when double quoted. (e.g. TAB="hi\tfriend" becomes hi friend) (#479)
    Open source →
  43. 1.26.22 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • build binaries with bytecode option (#477)
    Open source →
  44. 1.26.12 Dec 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add typescript type definitions for main.parse method (#475)
    Open source →
  45. 1.26.030 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add privateKey option to main.parse method (#474)
    Open source →
  46. 1.25.229 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • for binaries add pre-build step using esbuild (#471)

    Removed

    • remove types for functions that were removed a while back (2aa660)
    Open source →
  47. 1.25.126 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • improve helpful error messaging around decryption failures by specifying specific key and private key name (#463)
    Open source →
  48. 1.25.025 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add run --strict flag to exit with code 1 if any errors are encountered - like a missing .env file or decryption failure (#460)
    • add get --strict flag to exit with code 1 if any errors are encountered - like a missing .env file or decryption failure (#461)
    • add strict option to config() to throw for any errors (#459)

    Changed

    • log MISSING_ENV_FILE and DECRYPTION_FAILED errors to stderr (prior was stdout as a warning) (#459)

    Removed

    • remove dotenvx.get() function from lib/main.js. (parse already historically exists for this purpose) (#461)
    Open source →
  49. 1.24.522 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • 🐞 do not expand prior literal values (#458)
    Open source →
  50. 1.24.420 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • do not expand command substitution (#456)
    Open source →
  51. 1.24.320 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • 🐞 fix command substitution for more complex commands (#455)
    Open source →
  52. 1.24.218 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • treat pre-existing expandable values as literal in process.env (#450)
    Open source →
  53. 1.24.118 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    Open source →
  54. 1.24.015 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • support progressive append/update (#445)
    FOO=foo
    FOO=${FOO}bar
    # foobar
    
    • support alternate value expansion (#445)

    <img width="1608" alt="image" src="https://github.com/user-attachments/assets/fdd55a0a-9b36-4cb3-b0c6-6b019441aef4">

    Changed

    • dotenvx.parse now maps to dotenvx's internal parser. (prior it was mapping to dotenv's)

    Removed

    • removed dotenvx.configDotenv(). use dotenvx.config() (#445)
    Open source →
  55. 1.23.013 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • deeper variable expansion support and protection against self-referencing variables 🛡️ (#439)
    Open source →
  56. 1.22.212 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • more lenient handling of -- separator and better error messaging when flags are ambiguous (#438)
    Open source →
  57. 1.22.112 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • 🐞 patch loading order issue with single quotes (#436)
    Open source →
  58. 1.22.04 Nov 2024
    Release notesOpen source →
    Release notes2 sources agree

    Added

    • add --pattern argument to ext gitignore (dotenvx ext gitignore --pattern .env.keys) (#430)

    Changed

    • clarify next steps after first time encrypting (#430)
    Open source →
  59. 1.21.131 Oct 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • for --convention nextjs ignore .env.local for TEST environment (#425)
    • for precommit redirect missing dotenvx command using POSIX compliant redirection (#424)
    • make parent dotenvx help command less noisy by removing [options]. run dotenvx COMMAND -h to list all available options like always (#429)
    Open source →
  60. 1.21.025 Oct 2024
    Release notesOpen source →
    Release notes2 sources agree

    Changed

    • treat single quotes literally (#423)
    • respect user chosen quotes (#423 #377)

    🎓 now if you choose to single quote, double quote, no quote, or backtick your value it will be respected - including for encrypted values. this more intuitively handles complex cases like escaped characters, literals, and json.

    Open source →