envies

Teeny tiny .env loader

Usage

import {env} from "envies";
console.log(env.USER);

Details

It loads variables in ascending precedence from the following sources:

• .default.env in the script directory
• .default.env in the working directory
• .env in the script directory
• .env in the working directory
• .env.local in the script directory
• .env.local in the working directory
• The current environment variables

Notes

• Variables are loaded on-demand once when properties on env are first accessed
• The script directory is determined from process.argv[1]
• To change the default source filenames, set ENVIES_SOURCES=.example.env,.env in the environment.

TypeScript

By default, env is typed as Record<string, string | undefined>. If you know specific variables will always be set, you can narrow their types via an ambient declaration (e.g. in types.d.ts):

declare module "envies" {
  export const env: {
    DATABASE_URL: string;
    API_TOKEN: string;
  };
}

© silverwind, distributed under BSD licence