{"_id":"env-stage-loader","_rev":"6-dca7d084160e72295cbed50efb3fed96","name":"env-stage-loader","dist-tags":{"latest":"1.1.3"},"versions":{"1.0.0":{"name":"env-stage-loader","version":"1.0.0","keywords":["env","config"],"author":{"name":"DavidWells"},"license":"MIT","_id":"env-stage-loader@1.0.0","maintainers":[{"name":"davidwells","email":"davidgregorywells@gmail.com"}],"dist":{"shasum":"349cfa91c2afcc5e4ad6de23cb2ea5dff9361c27","tarball":"https://registry.npmjs.org/env-stage-loader/-/env-stage-loader-1.0.0.tgz","fileCount":3,"integrity":"sha512-OwgwhuLzVJwfcVnv9Ta1S3jwWj7CWuDPyMRukUFbVpcCJifhllk+9f9CEcVuBBrnusi9hwF30+i+QRJ9fYgxaQ==","signatures":[{"sig":"MEYCIQCfbqqrKWzqsZKfM/LcsPG5ja23CtFfj4fkpi3SWL7f3gIhAPCs+AtSg5p4nqI8VYtluYZASQD8j6yycEehpp47tsS1","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":3830,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfglyNCRA9TVsSAnZWagAAm/UP/0yEZgTyGaYOv+wnSRIF\n68IMhLBG0fW2pTl9t8hapzy4QCivb4OVgcTUuhS0nB06IFso6Wrv3CHNce8s\nnsibuySi5VFNIKtHNh+KRhaU/E3ev64lUTQTB5vSJSGm9/fwhR66B4fLFmN1\nBkrzaBlSgiBV3w8n8pyKwKp+ZC59NbBHlD8A29FGA2jIYpnflYubW9yaLbXd\nMxvsfom5WPQPUh8v46DXsP0Ad2KqZcbuqWV/sTgxwAuyJdYpw2A5J9zsqOcX\nR+vNj3YQ3BTN6Kc3ArjTjBvA6rjGwuHO62vv9EqYDAIaiyfAH/j0oeSsq23C\ntMZAAqp+LxP43EvP0yEF4cp6AQh8uIRhCDsQwoGqI/zfVEU8Rno/0wu12Fcm\n6rgQk8T/AhgWm7WfdR19jQANtJXhFiWiV/Jmh1msp7xzE8QtQGM9Voa4DfJ5\nQJZ5RBfUBBCAuBMyOil0nHcTtHE8X7YdNEOqOS1BQjibQT3r1zyee+baFI+n\nOTjYRTZ0nLaNmLytm6YNNYRKPDAo0n4ES3v6jRq0vLLHFfXenPU2M/4B/OQ0\nQ9KQe1rvEY+8vnQFfpWXq+aTMyIRLOiLSk0TQc7C1B1xx4yzB43cHMwu4/b5\n95nWsHrwcLVEbN/CkhC4MYg1NOBdnpuiR/I6cI04UycHqt6EhGwnHyn1cjqw\nSU5U\r\n=spNl\r\n-----END PGP SIGNATURE-----\r\n"},"main":"index.js","gitHead":"c2bd0bf472538acf3cd5b1acbc7988d3974b457d","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"davidwells","email":"davidgregorywells@gmail.com"},"_npmVersion":"6.10.0","description":"Loads `.env` files in order based on `process.env.NODE_ENV` value with [stage].local support","directories":{},"_nodeVersion":"12.7.0","dependencies":{"dotenv":"^8.2.0","dotenv-expand":"^5.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/env-stage-loader_1.0.0_1602378893158_0.10970848696328095","host":"s3://npm-registry-packages"}},"1.1.0":{"name":"env-stage-loader","version":"1.1.0","keywords":["env","env-loader","env-stages","config"],"author":{"name":"DavidWells"},"license":"MIT","_id":"env-stage-loader@1.1.0","maintainers":[{"name":"davidwells","email":"davidgregorywells@gmail.com"}],"dist":{"shasum":"3521c0bdcaa2295cd4dee5ea73699a30572a87a2","tarball":"https://registry.npmjs.org/env-stage-loader/-/env-stage-loader-1.1.0.tgz","fileCount":3,"integrity":"sha512-jsw9XSdqA82Bd6im36Po972R1LNhLZarau0z2YNCykxVVtQSirt+mB4V7Ed1hK/ChpRHMBz5xtw30cOa0oLfcA==","signatures":[{"sig":"MEYCIQDtIeWX/R90dwL6/VEM+vJPZGXx7T9SnHYMWVXROM1GtwIhAJxn0297NiyZO+6ZBhu93mBovsg7dOCYK91xb10/ZRS3","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":6756,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgWi4jCRA9TVsSAnZWagAAlQAP/RA0VjdX0upa6xZBe8eP\nhaLeQppwoFo1DvtyzYVbvS0zYWJ0BtYiikFv+/yfzDhvGGBSByMw1RuQsEm4\nUjMVDKoVRSGBU5Np11pWYBbs6q04gHvEKPbjx8LjlgZuIGQ76N+1Li6vKivX\nAwDOwdddBiJiGxK2zmZJz9YSLFmqC43npLzDAZ7CWrxMtXAfQ7SQZPzNjUOS\nkmWFvyISFidXfGBFAy+gkufXNr57HEn7mzt3p5RN5yyX6Y7IJtw6Vk6nuRpz\nDUegQUmd5VNFKCzeOMlENce54OhHSE8HbzX6IGV8pScWQTBf9nR+7l+j4i1w\nNKn+YjicRbz7k5mUdmkV1TKyZsYd/19qpm12z90MoYJ4MnqKYU6wfiiaR7u7\nEM8zsTKYeWQgj3rRaQJefdprARoFNrjc7FWMGaBFwEJzAR3qkXLPTE/aqsrP\nN/InOHXE6EsqA2T7GOQLIb4I1Zd9h2qKVnZcVnJ9L4lZTL9DqLBqzgQpJD3i\nGOpzocv+US42yN7FUxBPjNTuKzdJ/2qMruBjie8C6r8S7Lc5pJ5ykbwM2UXD\ngK+6cMaJcyELoFjP1/LxIB255JlY9gwOWc3aw4+yZDUkPFmfAFL4m8zHyGRf\nM2zaVrVBREuWgqAnSugfmgE3OiL9AmIIbK8xihtv+nkbdU1BDY+8hm768xAl\nJL6k\r\n=c7J4\r\n-----END PGP SIGNATURE-----\r\n"},"main":"index.js","gitHead":"fa5d3c5aa8deaba17c673b11021f6dd820329e9b","scripts":{"test":"ava ./tests/*.test.js -v","publish":"git push origin && git push origin --tags","release:major":"npm version major && npm publish","release:minor":"npm version minor && npm publish","release:patch":"npm version patch && npm publish"},"_npmUser":{"name":"davidwells","email":"davidgregorywells@gmail.com"},"_npmVersion":"6.10.0","description":"Loads `.env` files in order based on `process.env.NODE_ENV` value with [stage].local support","directories":{},"_nodeVersion":"12.7.0","dependencies":{"dotenv":"^8.2.0","dotenv-expand":"^5.1.0"},"_hasShrinkwrap":false,"devDependencies":{"ava":"^3.15.0"},"_npmOperationalInternal":{"tmp":"tmp/env-stage-loader_1.1.0_1616522786775_0.043789960479626355","host":"s3://npm-registry-packages"}},"1.1.1":{"name":"env-stage-loader","version":"1.1.1","keywords":["env","env-loader","env-stages","config"],"author":{"name":"DavidWells"},"license":"MIT","_id":"env-stage-loader@1.1.1","maintainers":[{"name":"davidwells","email":"davidgregorywells@gmail.com"}],"dist":{"shasum":"930f99d3464d178a413b7ca37658a52d4a7d13e9","tarball":"https://registry.npmjs.org/env-stage-loader/-/env-stage-loader-1.1.1.tgz","fileCount":3,"integrity":"sha512-YVZsPaqt5tO8q0vwh9y8Oww1KZhUesjEkUkLK/RD+ZKmd/hHB6ROdYTdiVGGhZFYPwlhBgzvl3ooYe8itI2EAg==","signatures":[{"sig":"MEYCIQDoG0uy+Gg2bayF/q1Wbaw8L6qUNPi+RI9qad51VR18KwIhANpn4NjRfyb/2kLRDWQtg/c3yYbm04nzkT5isWD4h0A1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7380},"main":"index.js","gitHead":"d27d0d2c6d34f8c9f06f6e6a6ca3e44b1a80761d","scripts":{"test":"ava ./tests/*.test.js -v","publish":"git push origin && git push origin --tags","release:major":"npm version major && npm publish","release:minor":"npm version minor && npm publish","release:patch":"npm version patch && npm publish"},"_npmUser":{"name":"davidwells","email":"davidgregorywells@gmail.com"},"_npmVersion":"10.9.0","description":"Loads `.env` files in order based on `process.env.NODE_ENV` value with [stage].local support","directories":{},"_nodeVersion":"22.11.0","dependencies":{"dotenv":"^8.2.0","dotenv-expand":"^5.1.0"},"_hasShrinkwrap":false,"devDependencies":{"ava":"^3.15.0"},"_npmOperationalInternal":{"tmp":"tmp/env-stage-loader_1.1.1_1748208780839_0.5895806414782343","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"env-stage-loader","version":"1.1.2","keywords":["env","env-loader","env-stages","config"],"author":{"name":"DavidWells"},"license":"MIT","_id":"env-stage-loader@1.1.2","maintainers":[{"name":"davidwells","email":"davidgregorywells@gmail.com"}],"dist":{"shasum":"0cf12512237e67a2701db7d96e5ff08684ce5756","tarball":"https://registry.npmjs.org/env-stage-loader/-/env-stage-loader-1.1.2.tgz","fileCount":3,"integrity":"sha512-rP8aD2dr3HCTPf7Y55w4XW/3kCCcyDYEsUqlP/20U7ydvKJKHG34vxc8+s3FCM3pnEHh1LHxqMzJxHbgwr6QGQ==","signatures":[{"sig":"MEQCIE7dgI79yvTAmORiktWBPaY41PuoHrSvY4YaRxx6EEJYAiAx/lm1axMSpPHGKFETr0NWRabO0Rp8WW8Zm2VJMB9gag==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":7791},"main":"index.js","gitHead":"c7d6cf252d116d7cb7b561f84e80bb3338275be0","scripts":{"test":"ava ./tests/*.test.js -v","publish":"git push origin && git push origin --tags","release:major":"npm version major && npm publish","release:minor":"npm version minor && npm publish","release:patch":"npm version patch && npm publish"},"_npmUser":{"name":"davidwells","email":"davidgregorywells@gmail.com"},"_npmVersion":"10.9.0","description":"Loads `.env` files in order based on `process.env.NODE_ENV` value with [stage].local support","directories":{},"_nodeVersion":"22.11.0","dependencies":{"dotenv":"^8.2.0","dotenv-expand":"^5.1.0"},"_hasShrinkwrap":false,"devDependencies":{"ava":"^3.15.0"},"_npmOperationalInternal":{"tmp":"tmp/env-stage-loader_1.1.2_1748368558950_0.1826680309204749","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"env-stage-loader","version":"1.1.3","description":"Loads `.env` files in order based on `process.env.NODE_ENV` value with [stage].local support","main":"index.js","scripts":{"test":"./run-tests.sh","publish":"git push origin && git push origin --tags","release:patch":"npm version patch && npm publish","release:minor":"npm version minor && npm publish","release:major":"npm version major && npm publish"},"keywords":["env","env-loader","env-stages","config"],"author":{"name":"DavidWells"},"license":"MIT","dependencies":{"dotenv":"^17.2.2","dotenv-expand":"^12.0.3"},"devDependencies":{"uvu":"^0.5.6"},"_id":"env-stage-loader@1.1.3","gitHead":"f64c9f5c5cb734bdbadd7a6d3d4712cd41a477ba","_nodeVersion":"22.11.0","_npmVersion":"10.9.0","dist":{"integrity":"sha512-mgTNl785IxvFVYVv1tfqDYI1Kc1+fBZqg1mLned9xnO9Rh/2Dy68md57Mccs3Fts9bSMmNblm4bGUThGQRGNGQ==","shasum":"299a281bfb26fed967d7bf8fd3891e233e99eca8","tarball":"https://registry.npmjs.org/env-stage-loader/-/env-stage-loader-1.1.3.tgz","fileCount":3,"unpackedSize":7904,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHkFqaV4aYixUHyPycy3Yk/KfAXOtfc2+cO3VcIMzaYnAiEAhFDhjII/we7m7KhDVhYQbFYJJTPMIMlWVY+Q+4YlPig="}]},"_npmUser":{"name":"davidwells","email":"davidgregorywells@gmail.com"},"directories":{},"maintainers":[{"name":"davidwells","email":"davidgregorywells@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/env-stage-loader_1.1.3_1759023684120_0.012002928124967616"},"_hasShrinkwrap":false}},"time":{"created":"2020-10-11T01:14:53.158Z","modified":"2025-09-28T01:41:24.475Z","1.0.0":"2020-10-11T01:14:53.295Z","1.1.0":"2021-03-23T18:06:27.116Z","1.1.1":"2025-05-25T21:33:01.019Z","1.1.2":"2025-05-27T17:55:59.105Z","1.1.3":"2025-09-28T01:41:24.293Z"},"author":{"name":"DavidWells"},"license":"MIT","keywords":["env","env-loader","env-stages","config"],"description":"Loads `.env` files in order based on `process.env.NODE_ENV` value with [stage].local support","maintainers":[{"name":"davidwells","email":"davidgregorywells@gmail.com"}],"readme":"# Env Stage Loader\n\nLoads `.env` files in order based on `process.env.NODE_ENV` value.\n\n1. shell\n2. .env.{environment}.local\n3. .env.{environment}\n4. .env.local\n5. .env\n\nIf environment variable is set, any file loaded after will not override it.\n\n## Usage\n\nImport and use asap in your build process or app\n\n```js\nconst loadStageEnv = require('env-stage-loader')\n\n// Load env variables\nconst values = loadStageEnv()\nconsole.log('resolved values', values)\n\n// Debug load order & value setting\nloadStageEnv({ debug: true })\n\n// Set env dynamically\nloadStageEnv({\n  env: 'development'\n})\n\n// Force override of any env variable\nloadStageEnv({\n  forceSet: {\n    FOO: 'this value will win'\n  }\n})\n\n// Force override of any env variable\nloadStageEnv({\n  env: 'development'\n  // Force unsetting of all previously found ENV vars found in shell\n  unloadEnv: true\n})\n```\n\n## Examples\n\n**[stage].local takes presidence**\n\n```js\n/*\n.env.dev.local contains FOO=BAR\n.env.dev contains FOO=ZAZ\n*/\n\nconst values = loadStageEnv({ env: 'dev' })\n\nconsole.log(values.FOO === process.env.FOO)\nconsole.log(process.env.FOO)\n// value \"BAR\" from .env.dev.local\n```\n\n**shell takes presidence**\n\n```js\n/*\nprocess.env.XYZ === '123'\n.env.dev.local contains XYZ=345\n.env.dev contains XYZ=987\n*/\n\nconst values = loadStageEnv({ env: 'dev' })\n\nconsole.log(process.env.XYZ)\n// value \"123\" from original shell process\n```\n\nAnother shell example\n\n```bash\n# Shell value set\nexport FOO=1\n```\n\nFOO is set in shell session...\n\n```js\n/*\n.env file contains FOO=ZAZ\n*/\n\nconst values = loadStageEnv({ env: 'dev' })\n\nconsole.log(process.env.FOO)\n// process.env.FOO === \"1\" because shell takes precedence\n```\n\nRun `tests` for more examples.\n\n## Typical `.env` files used\n\n- `.env`: Default.\n- `.env.local`: Local overrides. **This file is loaded for all environments except test.**\n- `.env.development`, `.env.test`, `.env.production`: Environment-specific settings.\n- `.env.development.local`, `.env.test.local`, `.env.production.local`: Local overrides of environment-specific settings.\n\nFiles on the left have more priority than files on the right:\n\n- `npm start`: `.env.development.local`, `.env.local`, `.env.development`, `.env`\n\nThese variables will act as the defaults if the machine does not explicitly set them.\n\nPlease refer to the [dotenv documentation](https://github.com/motdotla/dotenv) for more details.\n\n## Alternative Packages\n\n- [dotenv-flow](https://github.com/kerimdzhanov/dotenv-flow)\n- https://www.npmjs.com/package/universal-dotenv\n- https://github.com/thenativeweb/nodeenv\n- https://github.com/af/envalid\n","readmeFilename":"README.md"}