npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

dotenv-mono

v1.3.14

Published

This package permit to have a centralized dotenv on a monorepo. It also includes some extra features such as manipulation and saving of changes to the dotenv file, a default centralized file, and a file loader with ordering and priorities.

Downloads

91,920

Readme

Dotenv mono

If this project has helped you out, please support us with a star 🌟

NPM version js-prettier-style

📘 Description

What is this?

To prevent code duplication and enhance re-usability, a centralized configuration including all of your environment variables might be handy. Rather of generating a .env file for each package, we may utilize a single .env file at the project's root.

This is a package that allows monorepo applications and packages to share and load a centralized dotenv. It's based over dotenv package.

It also includes some extra features such as manipulation and saving of changes to the dotenv file, a default centralized file, and a file loader with ordering and priorities.

The plugin dotenv-expand is enabled by default.

Structure Example
├── .env
├── .env.production
├── .env.defaults
├── packages
│   ├── ui-library
│   ├── other-library
├── apps
│   ├── web
│   │   ├── .storybook
│   ├── docs

How it works?

The package search the first .env file, matching with some priority criteria, by walking up the parent directories.

Priorities

Starting from the current process directory, this package finds the first file that matches the best filepath and filename criteria with the highest priority. The greater the depth of the up folder, the lesser its priority.

The priority can be customized on the configuration with the priorities property, see the example below on the usage section.

Note: The allowed values for NODE_ENV are usually test, development and production.

| Priority | Filename | | -------- | ------------------------ | | 75 | .env.$(NODE_ENV).local | | 50 | .env.local | | 25 | .env.$(NODE_ENV) | | 1 | .env |

Example

Given the following folder structure with dotenv files:

├── .env
├── .env.production
├── apps
│   ├── .env.development
│   ├── web
│   ├── docs
│   │   ├── .env
│   │   ├── .env.local

Having the following priority order:

| Path | Priority | Depth | | ----------------------- | -------- | ----- | | .env | 1 | 2 | | .env.production | 25 | 2 | | apps/.env.development | 25 | 1 | | apps/docs/.env | 1 | 0 | | apps/docs/.env.local | 50 | 0 |

Then we will have the following outcome scenarios:

| Current working directory | Env | Match | | ------------------------- | ------------- | ----------------------- | | / | development | .env | | / | production | .env.production | | apps/web | development | .env | | apps/web | development | apps/.env.development | | apps/docs | development | apps/docs/.env.local |

📖 Install

Install the library from npm or yarn just running one of the following command lines:

| npm | yarn | | -------------------------------- | ---------------------- | | npm install dotenv-mono --save | yarn add dotenv-mono |

Install on Next.js

For custom advanced configuration of Next.js, you can create a next.config.js or next.config.mjs file in the root of your project directory (next to package.json).

Add the following line at the top of the file:

require("dotenv-mono").load();
Example
require("dotenv-mono").load();

/**
 * @type {import('next').NextConfig}
 */
const nextConfig = {
	/* config options here */
};

module.exports = nextConfig;

Install on Storybook

The main configuration file is .storybook/main.js. This file controls the Storybook server's behavior, so you must restart Storybook’s process when you change it.

Add the following lines on the file:

const dotenv = require("dotenv-mono").load();

const config = {
	/* config options here */
	env: (config) => {
		return {
			...config,
			...dotenv.env,
		};
	},
};

module.exports = config;

💻 Usage

Load

Simple methods to export environment variables from the dotenv into the working process. Here are several potential implementation approaches based on your preferences.

// Inline
require("dotenv-mono").load(/* config */);

// Using the function
const {dotenvLoad} = require("dotenv-mono");
dotenvLoad(/* config */);

// Using import
import {dotenvLoad} from "dotenv-mono";
const dotenv = dotenvLoad(); // Dotenv instance

// Using the class
const {Dotenv} = require("dotenv-mono");
const dotenv = new Dotenv(/* config */);
dotenv.load();

Having the dotenv output

If you need a fast way to replace dotenv package with dotenv-mono, and you need also to have a retro-compatible feature, you can have back directly the output like dotenv package using the config method.

// Inline
const output = require("dotenv-mono").config(/* config */);

// Using the function
const {dotenvConfig} = require("dotenv-mono");
const output = dotenvConfig(/* config */);

Load file with extension

// Use `.dotenv.server` or `.dotenv.server.local`, etc...
load({extension: "server"});

Load specific file

// You can specify the file path
load({path: "../../configs/.env"});

Load without dotenv-expand extension

load({expand: false});

Change default filename

load({defaults: ".env.def"});

Change priorities

// If `.dotenv.overwrite` is present use it with max priority
load({
	priorities: {
		".env.overwrite": 100,
	},
});

Make changes

const dotenv = require("dotenv-mono").load();
dotenv.save({"MY_ENV_1": "enjoy"});

// Without loading into the working process
const {Dotenv} = require("dotenv-mono");
const dotenv = new Dotenv();
dotenv.loadFile(); // Skip loading into the process
dotenv.save({
	"MY_ENV_1": "enjoy",
	"MY_ENV_2": "'enjoy quotes'",
	"MY_ENV_3": 999,
});

Preload

As on the dotenv package on the CLI/Console, you can use the --require (-r) command line option to preload dotenv. By doing this, you do not need to require and load dotenv in your application code.

$ node -r dotenv-mono/load your_script.js

The configuration options below are supported as command line arguments in the format dotenv_config_<option>=value

$ node -r dotenv-mono/load your_script.js dotenv_config_path=/custom/path/to/.env dotenv_config_debug=true

Additionally, you can use environment variables to set configuration options. Command line arguments will precede these.

$ DOTENV_CONFIG_<OPTION>=value node -r dotenv-mono/load your_script.js
$ DOTENV_CONFIG_ENCODING=latin1 DOTENV_CONFIG_DEBUG=true node -r dotenv-mono/load your_script.js dotenv_config_path=/custom/path/to/.env

💡 Methods

Config

| Setting | Description | Default | | ------------ | --------------------------------------------------------------------------------------------------------------- | ----------------------------- | | cwd | Specify the current working directory | process.cwd() | | debug | Turn on/off logging to help debug why certain keys or values are not being set as you expect | false | | defaults | Specify the defaults dotenv filename (it can't override any environment variables) | .env.defaults | | depth | Specify the max depth to reach finding up the folder from the children directory | 4 | | encoding | Specify the encoding of your file containing environment variables | utf8 | | expand | Turn on/off the dotenv-expand plugin | true | | extension | Specify to load specific dotenv file used only on specific apps/packages (ex. .env.server...) | | | override | Override any environment variables that have already been set on your machine with values from your .env file | false | | path | Specify a custom path if your file containing environment variables is located elsewhere | | | priorities | Specify the criteria of the filename priority to load as dotenv file | See Priorities |

Dotenv Methods

Load Environments

It will read your .env file following the criteria, parse the contents, assign it to process.env.

Note: This method differs from the previous load function. In that it requires the configuration to be loaded on the class instance via the constructor.

public load(loadOnProcess: boolean): Dotenv;

Load File

It will read your .env file following the criteria, parse the contents, ready to be read or changed programmatically.

public loadFile(): Dotenv;

Save

Merge the data on input with the loaded data from load or loadFile, and save the changes on the original dotenv file.

Note: If .env.defaults is present, it won't be overwritten, you can just save the changes on the main dotenv file (.env, .env.local, etc...)

public save(changes: Record<string, any>): Dotenv;

Parse

See the dotenv documentation HERE

public parse<T extends Record<string, any> = Record<string, any>>(src: string | Buffer): T;

🤔 How to contribute

Have an idea? Found a bug? Please raise to ISSUES or PULL REQUEST. Contributions are welcome and are greatly appreciated! Every little bit helps, and credit will always be given.