The env splitting, delivery, replacement, and monitoring tool for monorepo

LEM stands for Local Env Manager, and its logo is inspired by Lemmings. This tool is designed for monorepos where back-end APIs, front-end UIs, infrastructure resources, and more are managed together. It provides utilities to centrally manage .env files and distribute them to separate directory roots according to your configuration. The basic concept is to use prefixes for environment variable management, while also supporting unprefixed variables for flexible delivery.

This tool supports the following features:

• Generate a template for the configuration file
• Validate configuration with fine granularity
• Switch stages and persist the current stage
• Split, replace prefixes, and distribute the central .env to each directory
• Monitor the central .env and reflect changes automatically
• Detect empty environment variable values and exit with an error
• Automatically generate .envrc and use watch_file for direnv integration

NAME:
   lem - The local env manager for monorepo

USAGE:
   lem [global options] [command [command options]]

VERSION:
   0.0.0 (revision: XXXXXXX)

COMMANDS:
   init      Initialize the configuration file to current directory
   validate  Validate that the configuration file is executable
   stage     Show the current stage context
   switch    Toggle the current stage to the specified stage
   list      Show the env file entries in the current stage
   run       Switch env and deliver env files to the specified directory
   watch     Watch changes in the central env and run continuously

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

Set up with TOML format as follows:

[stage]
default = "<central-env-dir>/.env"
dev = "<central-env-dir>/.env.development"
stg = "<central-env-dir>/.env.staging"
prod = "<central-env-dir>/.env.production"

[group.api]
prefix = "API"
dir = "./backend"
replace = ["REPLACEABLE1"]
plain = ["PLAIN1"]
check = true
direnv = ["api", "ui"]

[group.ui]
prefix = "UI"
dir = "./frontend"
replace = ["REPLACEABLE2"]
plain = ["PLAIN2"]
check = true
direnv = ["ui"]

Install with homebrew

brew install nekrassov01/tap/lem

Install with go

go install github.com/nekrassov01/lem@latest

Or download binary from releases

Supported Shells are as follows:

• bash
• zsh
• fish
• pwsh

lem completion bash|zsh|fish|pwsh

# In the case of bash
source <(lem completion bash)

• Support direnv Integration
• Logging

nekrassov01

MIT