You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

7.2 KiB

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

Unreleased

12.0.3 (2025-09-02)

Added

  • 🙏 A big thank you to new sponsor Tuple.app - the premier screen sharing app for developers on macOS and Windows. Go check them out. It's wonderful and generous of them to give back to open source by sponsoring dotenv. Give them some love back.

12.0.2 (2025-05-16)

Added

  • 🎉 Added new sponsor Graphite - the AI developer productivity platform helping teams on GitHub ship higher quality software, faster.

[!TIP] Become a sponsor

The dotenvx-expand README is viewed thousands of times DAILY on GitHub and NPM. Sponsoring dotenv and dotenv-expand is a great way to get in front of developers and give back to the developer community at the same time.

12.0.1 (2024-11-18)

Changed

  • break logic on runningParsed (#ad887)

12.0.0 (2024-11-16)

Added

  • 🎉 support alternate value expansion (see usage) (#131)

Changed

  • 🎉 Expansion logic rewritten to match dotenvx (#131)

NOTE: I recommend dotenvx over dotenv-expand when you are ready. I'm putting all my effort there for a unified standard .env implementation that works everywhere and matches bash, docker-compose, and more. In some cases it slightly improves on them - leading to more reliability for your secrets and config.

  • ⚠️ BREAKING: do NOT attempt expansion of process.env (#131)

This has always been dangerous (unexpected side effects) and is now removed. process.env should not hold values you want to expand. If for some reason you need equivalent abilities, use dotenvx. You can ship an encrypted .env file with your code - allowing safe expansion at runtime - rather than relying on trying to expand pre-existing process.env values that could for good reason have a dollar sign in them (example a password).

11.0.7 (2024-11-13)

Changed

  • 🐞 fix self-expanding undefined variable with default value (#126)

11.0.6 (2024-02-17)

Changed

  • Fix .nyc_output in .npmignore

11.0.5 (2024-02-17)

Changed

  • 🐞 fix recursive expansion when expansion key is sourced from process.env (#121)

11.0.4 (2024-02-15)

Changed

  • 🐞 fix recursive expansion when expansion keys in reverse order (#118)

11.0.3 (2024-02-11)

Changed

  • 🐞 bug fix when processEnv set to process.env rather than empty object (also test fixes which hid the bug) (#113)

11.0.2 (2024-02-10)

Changed

11.0.1 (2024-02-10)

Added

  • Added funding link in package.json

11.0.0 (2024-02-10)

Added

  • Add typings for import dotenv-expand/config (#99)
  • Support expansion of dot in env variable names like POSTGRESQL.BASE.USER (#93)
  • Add processEnv option (#105)
  • Add support for default format of ${VAR-default} (#109)

Changed

  • Do not expand prior process.env environment variables. NOTE: make sure to see updated README regarding dotenv.config({ processEnv: {} }) (#104)
  • 🐞 handle $var1$var2 (#103, #104)
  • 🐞 fix fatal recursive error when variable defines value with same variable VAR=$VAR #98

Removed

  • Remove ignoreProcessEnv option (use processEnv option going forward)

10.0.0 (2022-12-16)

Added

  • Support special characters in default expansion (#74)

9.0.0 (2022-08-30)

Added

  • Proper support for preload and cli args (#78)

8.0.3 (2022-03-21)

Changed

  • 🐞 Fixed defaults bug (#71)

8.0.2 (2022-03-11)

Changed

  • 🐞 Fixed preloading bug

8.0.1 (2022-02-03)

Added

  • Added config.js to package.json lookups

8.0.0 (2022-02-03)

Changed

  • Breaking: Bump to v16.0.0 of dotenv

Added

  • Preload support 🎉 (#31)

7.0.0 (2022-01-17)

Changed

  • Breaking: Bump to v15.0.0 of dotenv

6.0.1 (2022-01-17)

Changed

  • Updated README

6.0.0 (2022-01-17)

Changed

  • Breaking Move default export to export of expand function (#14b1f2)

Added

  • Add default expansion 🎉 (#39)
  • Add missing type descriptions

5.1.0 and prior

Please see commit history.