envmerge

🔧 CLI tool to recursively merge multiple .env files into a single consolidated file.

---

✨ Features

• 🔍 Recursively scans folders to find .env files
• 🧠 Skips common junk/build folders (node_modules, dist, .venv, etc.)
• 📦 Merges all key-value pairs into one file (with comments showing file origin)
• ✅ Supports verbose logging
• ⚡️ Blazing fast and TypeScript-powered

---

📦 Installation

npm install -g @creatoon/envmerge

npx @creatoon/envmerge --help

---

🚀 Usage

envmerge --path <folder> --output <out-folder> [--verbose]

Example:

envmerge --path ./projects --output ./env --verbose

This will generate:

./env/merged.txt

With content like:

# From: ./projects/service-a/.env
PORT=3000
DB_URL=postgres://a

# From: ./projects/service-b/.env
PORT=5000
API_KEY=abc123

---

🛠 CLI Options

Flag	Description	Type	Required
--path	Root folder to scan	string	✅
--output	Output directory to save merged file	string	✅
--verbose	Enable detailed logs	boolean	❌
--help	Show usage help	boolean	❌

---

🧠 Why Use This?

Managing .env files in monorepos or multi-service projects is painful.
envmerge makes it easy to consolidate configs while keeping source context.

---

📄 License

MIT © Creatoon