envsetter 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zain Afzal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+# ⚡ EnvSetter
+
+> Stop manually writing `KEY=VALUE`. Scan your codebase, paste values, done.
+
+EnvSetter scans your entire codebase for environment variable references (`process.env.X`,
+`import.meta.env.X`, `.env.example` files, etc.), shows you which ones are
+missing, and gives you a clean interactive interface to fill them in.
+
+---
+
+## Install
+
+```bash
+npm install -g envsetter
+```
+
+## Usage
+
+```bash
+cd your-project
+envsetter
+```
+
+That's it. It will:
+
+1. 🔍 **Scan** your codebase for every env variable reference
+2. 📂 **Discover** all folders with `.env` files (monorepo support)
+3. 📋 **Show** which are already set and which are missing
+4. ✏️ **Prompt** you with a clean interactive interface
+5. 💾 **Save** everything to your `.env` file with proper formatting
+6. 🔄 **Sync** keys to `.env.example` automatically
+
+---
+
+## Features
+
+### 🎯 Smart Scanning
+- Deep scanning across **20+ file types** and all major languages
+- Detects patterns like `process.env.VAR`, `os.environ`, `env('VAR')` and more
+- Reads `.env.example` files to find expected variables
+
+### 📂 Multi-Folder Support
+- Automatically discovers all folders containing `.env` files
+- Navigate between folders in monorepos and multi-service projects
+- Process individual folders or edit all at once
+
+### ⬆ Bulk Paste
+- Paste your entire `.env` content in one go
+- Automatically parses `KEY=VALUE` pairs, handles quotes, comments, messy formatting
+- Preview what was parsed before confirming
+
+### 🔐 Security Aware
+- Masks sensitive values (passwords, tokens, API keys) in the UI
+- Warns if `.env` is not in `.gitignore`
+- Auto-detects secret keys by pattern
+
+### ✨ Smart Hints
+- Categorizes variables (Database, AWS, Auth, Email, etc.)
+- Shows type hints (URL, Secret, Number, Flag)
+- Displays where each variable is used in your code
+
+### 📝 Auto-Sync `.env.example`
+- Automatically syncs new keys to `.env.example` (without values)
+- Creates `.env.example` if it doesn't exist
+- Team-friendly — everyone knows what keys are needed
+
+### 🎨 Beautiful UI
+- Progress bars, category grouping, colored output
+- Interactive prompts with commands: `skip`, `back`, `clear`, `list`, `exit`, `skipall`
+- Clean boxed layouts and visual hierarchy
+
+---
+
+## What It Detects
+
+| Pattern                 | Language/Framework |
+| ----------------------- | ------------------ |
+| `process.env.VAR`       | Node.js            |
+| `process.env['VAR']`    | Node.js            |
+| `import.meta.env.VAR`   | Vite               |
+| `NEXT_PUBLIC_*`         | Next.js            |
+| `REACT_APP_*`           | Create React App   |
+| `VITE_*`                | Vite               |
+| `NUXT_*`                | Nuxt               |
+| `EXPO_PUBLIC_*`         | Expo               |
+| `os.environ.get('VAR')` | Python             |
+| `ENV["VAR"]`            | Ruby               |
+| `env('VAR')`            | Laravel            |
+| `System.getenv("VAR")`  | Java               |
+| `os.Getenv("VAR")`      | Go                 |
+| `std::env::var("VAR")`  | Rust               |
+| `${VAR}`                | Docker/YAML        |
+| `.env.example` entries  | Any                |
+
+---
+
+## Modes
+
+### Fill Missing
+Only prompts for variables that don't have a value yet.
+
+### Edit All
+Re-prompts for every variable, letting you update existing values.
+
+### Bulk Paste
+Paste a whole `.env` file content at once — perfect for migrating from Vercel, Railway, or another project.
+
+---
+
+## Commands (during prompts)
+
+| Command   | Action                          |
+| --------- | ------------------------------- |
+| `skip`    | Skip this variable              |
+| `back`    | Go to the previous variable     |
+| `clear`   | Set value to empty string       |
+| `list`    | Show all variables and status   |
+| `skipall` | Skip all remaining variables    |
+| `exit`    | End session (with confirmation) |
+| `?`       | Show help panel                 |
+
+---
+
+## How It Works
+
+```
+ ╭─────────────────────────────────────────────────────╮
+ │                                                     │
+ │   _____ _   ___     __                              │
+ │  | ____| \ | \ \   / /                              │
+ │  |  _| |  \| |\ \ / /                               │
+ │  | |___| |\  | \ V /                                │
+ │  |_____|_| \_|  \_/                                 │
+ │                                                     │
+ │    --- S E T T E R ---                              │
+ │                                                     │
+ │    Scan > Fill > Save  |  Interactive .env manager  │
+ │    v1.0.0                                           │
+ │                                                     │
+ ╰─────────────────────────────────────────────────────╯
+
+  ◆ ✔ Found env files in 3 folders
+
+  >> Project Folders ───────────────────────────
+
+  ? Select folder
+  > ./  (root)           3 env files
+    backend/             1 env file
+    frontend/            2 env files
+    Edit all folders
+
+  ◆ Working in: backend
+
+  ╭────────────────────────────────────────────────╮
+  │  ◆ Scan Results                                │
+  │    ●  Variables found      8                   │
+  │    ●  Already set         3                    │
+  │    ●  Missing             5                    │
+  │    Coverage  ████████░░░░░░░░░░░░  38%          │
+  ╰────────────────────────────────────────────────╯
+
+  ? Select mode
+  > ▸ Fill missing only   5
+    ✎ Edit all variables  8
+    ⬆ Bulk paste  (paste whole .env content)
+    ✖ Exit
+
+  ╭──────────────────────────────────────────────╮
+  │ ◆ DATABASE_URL  [1/5]  0%                   │
+  │ ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░             │
+  │ URL  Database connection string              │
+  │ ● Not set                                    │
+  ╰──────────────────────────────────────────────╯
+
+  ▸ Value: postgresql://user:pass@localhost:5432/db
+
+  ╭──────────────────────────────────────────────────╮
+  │                ✔  Complete                       │
+  │   Saved     5 variables                          │
+  │   Target    .env                                 │
+  ╰──────────────────────────────────────────────────╯
+```
+
+---
+
+## License
+
+MIT © [Zain Afzal](https://zainafzal.dev)

package/bin/envsetter.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+"use strict"
+
+const {main} = require("../src/index")
+
+main().catch(err => {
+  console.error(err)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "envsetter",
+  "version": "1.0.0",
+  "description": "Interactive CLI to scan your codebase for environment variables and set their values — no more manually writing KEY=VALUE.",
+  "main": "src/index.js",
+  "bin": {
+    "envsetter": "./bin/envsetter.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "env",
+    "dotenv",
+    "cli",
+    "environment",
+    "variables",
+    "setter",
+    "scanner",
+    "interactive",
+    "env-manager",
+    "bulk-paste",
+    "monorepo",
+    "multi-folder",
+    "env-example"
+  ],
+  "author": "Zain Afzal (https://zainafzal.dev)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sheikhmuhammadzain/envsetter.git"
+  },
+  "homepage": "https://github.com/sheikhmuhammadzain/envsetter#readme",
+  "bugs": {
+    "url": "https://github.com/sheikhmuhammadzain/envsetter/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "figures": "^3.2.0",
+    "glob": "^8.1.0",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1"
+  }
+}

package/src/index.js

@@ -0,0 +1,271 @@
+"use strict"
+
+const path = require("path")
+const ora = require("ora")
+const chalk = require("chalk")
+
+const {scanCodebase, scanEnvFilesOnly, parseExistingEnv, discoverEnvFolders} = require("./scanner")
+const {
+  showBanner,
+  showScanResult,
+  askMode,
+  askEnvFile,
+  askFolder,
+  promptForValues,
+  askBulkPaste,
+  showSummary,
+} = require("./ui")
+const {writeEnvFile, ensureGitignore, syncToEnvExample} = require("./writer")
+
+// Theme colors matching ui.js
+const T = {
+  accent: "#3B82F6",
+  cyan: "#22D3EE",
+  green: "#10B981",
+  yellow: "#F59E0B",
+  red: "#EF4444",
+  purple: "#A78BFA",
+  text: "#F4F4F5",
+  textSecondary: "#A1A1AA",
+  textMuted: "#71717A",
+  textSubtle: "#52525B",
+}
+
+/**
+ * Process a single folder — scan, select env file, fill values
+ */
+async function processFolder(folderPath, isDeepScan, folderLabel) {
+  const hasUsableValue = (envMap, key) => {
+    if (!envMap.has(key)) return false
+    const value = envMap.get(key)
+    return typeof value === "string" && value.trim().length > 0
+  }
+
+  // Show which folder we're working on
+  if (folderLabel) {
+    console.log("")
+    console.log(
+      chalk.hex(T.accent)(`  › `) +
+      chalk.bold.hex(T.text)(`Working in: `) +
+      chalk.bold.hex(T.accent)(folderLabel),
+    )
+    console.log(chalk.hex(T.textSubtle)(`  ${"─".repeat(50)}`))
+    console.log("")
+  }
+
+  // ── Scanning Phase ──────────────────────────────────────────────────────────
+  const scanLabel = isDeepScan
+    ? "Deep scanning for environment variables"
+    : "Scanning env files for environment variables"
+
+  const spinner = ora({
+    text: chalk.hex(T.textSecondary)(scanLabel),
+    spinner: "dots12",
+    color: "cyan",
+    prefixText: chalk.hex(T.accent)("  ›"),
+  }).start()
+
+  let foundVars
+  try {
+    foundVars = isDeepScan ? scanCodebase(folderPath) : scanEnvFilesOnly(folderPath)
+  } catch (err) {
+    spinner.fail(chalk.hex(T.red)("Failed to scan for environment variables"))
+    console.error(err)
+    return {saved: 0, skipped: true}
+  }
+
+  spinner.succeed(chalk.hex(T.green)("Scan complete"))
+  console.log("")
+
+  // ── No Variables Found ──────────────────────────────────────────────────────
+  if (foundVars.size === 0) {
+    console.log(
+      chalk.hex(T.yellow)(
+        `  ⚠ No environment variables found.\n` +
+          chalk.hex(T.textMuted)(`  Try: envsetter --deep\n`),
+      ),
+    )
+    return {saved: 0, skipped: true}
+  }
+
+  // ── Select Target File ─────────────────────────────────────────────────────
+  const envFilePath = await askEnvFile(folderPath)
+  const fullEnvPath = path.resolve(folderPath, envFilePath)
+  const existingEnv = parseExistingEnv(fullEnvPath)
+  console.log("")
+
+  // ── Show Scan Summary ──────────────────────────────────────────────────────
+  const {missing, alreadySet} = showScanResult(foundVars, existingEnv)
+  const mode = await askMode(missing, alreadySet)
+
+  if (mode === "exit") {
+    console.log(chalk.hex(T.textMuted)("\n  Skipped this folder.\n"))
+    return {saved: 0, skipped: true}
+  }
+
+  // ── Bulk Paste Mode ────────────────────────────────────────────────────────
+  if (mode === "bulk") {
+    const bulkVars = await askBulkPaste()
+    if (!bulkVars || bulkVars.size === 0) {
+      showSummary(0, envFilePath)
+      return {saved: 0, skipped: false}
+    }
+
+    const savedCount = writeEnvFile(fullEnvPath, bulkVars, existingEnv)
+
+    // Sync to .env.example
+    const savedKeys = [...bulkVars.keys()]
+    if (savedKeys.length > 0) {
+      const synced = syncToEnvExample(savedKeys)
+      if (synced > 0) {
+        console.log(
+          chalk.hex(T.green)(
+            `  ✔ Synced ${synced} new ${synced > 1 ? "keys" : "key"} to .env.example`,
+          ),
+        )
+      }
+    }
+
+    showSummary(savedCount, envFilePath)
+    return {saved: savedCount, skipped: false}
+  }
+
+  // ── Determine Variables to Fill ────────────────────────────────────────────
+  let varsToFill
+  if (mode === "missing") {
+    varsToFill = [...foundVars.keys()].filter(k => !hasUsableValue(existingEnv, k))
+  } else {
+    varsToFill = [...foundVars.keys()]
+  }
+
+  if (varsToFill.length === 0) {
+    console.log(
+      chalk.hex(T.green)(`\n  ✔ All environment variables are already set!\n`),
+    )
+    return {saved: 0, skipped: false}
+  }
+
+  // ── Interactive Fill ───────────────────────────────────────────────────────
+  let savedCount = 0
+  const newValues = await promptForValues(
+    varsToFill,
+    existingEnv,
+    foundVars,
+    async (key, value) => {
+      const written = writeEnvFile(fullEnvPath, new Map([[key, value]]), existingEnv)
+      savedCount += written
+      existingEnv.set(key, value)
+    },
+  )
+
+  if (newValues.size === 0) {
+    showSummary(0, envFilePath)
+    return {saved: 0, skipped: false}
+  }
+
+  // ── Gitignore Check ────────────────────────────────────────────────────────
+  const isIgnored = ensureGitignore(envFilePath)
+  if (isIgnored === false) {
+    console.log("")
+    console.log(
+      chalk.hex(T.yellow)(
+        `  ⚠ ${chalk.bold(envFilePath)} is ${chalk.bold("NOT")} in .gitignore!`,
+      ),
+    )
+    console.log(
+      chalk.hex(T.textMuted)(
+        `    Run: ${chalk.hex(T.accent)(`echo "${path.basename(envFilePath)}" >> .gitignore`)}`,
+      ),
+    )
+  }
+
+  // ── Sync keys to .env.example ──────────────────────────────────────────────
+  const savedKeys = [...newValues.keys()]
+  if (savedKeys.length > 0) {
+    const synced = syncToEnvExample(savedKeys)
+    if (synced > 0) {
+      console.log(
+        chalk.hex(T.green)(
+          `  ✔ Synced ${synced} new ${synced > 1 ? "keys" : "key"} to .env.example`,
+        ),
+      )
+    }
+  }
+
+  showSummary(savedCount, envFilePath)
+  return {saved: savedCount, skipped: false}
+}
+
+async function main() {
+  const cwd = process.cwd()
+  const isDeepScan = process.argv.includes("--deep")
+
+  showBanner()
+
+  // ── Discover Folders with Env Files ────────────────────────────────────────
+  const discoverSpinner = ora({
+    text: chalk.hex(T.textSecondary)("Discovering folders with env files..."),
+    spinner: "dots12",
+    color: "cyan",
+    prefixText: chalk.hex(T.accent)("  ›"),
+  }).start()
+
+  const folders = discoverEnvFolders(cwd)
+
+  if (folders.length === 0) {
+    discoverSpinner.warn(chalk.hex(T.yellow)("No env files found in any folder"))
+    console.log("")
+
+    if (!isDeepScan) {
+      console.log(
+        chalk.hex(T.textMuted)(`  Try deep scanning to find env references in code:\n`) +
+        chalk.hex(T.accent)(`  $ envsetter --deep\n`),
+      )
+    }
+
+    // Fall back to running on cwd directly
+    discoverSpinner.stop()
+    await processFolder(cwd, isDeepScan, null)
+    return
+  }
+
+  discoverSpinner.succeed(
+    chalk.hex(T.green)(
+      `Found env files in ${folders.length} folder${folders.length > 1 ? "s" : ""}`,
+    ),
+  )
+  console.log("")
+
+  // ── Folder Selection ───────────────────────────────────────────────────────
+  const selected = await askFolder(folders)
+
+  if (selected === "all") {
+    // Process all folders sequentially
+    let totalSaved = 0
+    for (let i = 0; i < folders.length; i++) {
+      const folder = folders[i]
+      const folderLabel = `${folder.relPath === "." ? "./ (root)" : folder.relPath}  [${i + 1}/${folders.length}]`
+      const result = await processFolder(folder.absPath, isDeepScan, folderLabel)
+      totalSaved += result.saved
+    }
+
+    if (totalSaved > 0) {
+      console.log("")
+      console.log(
+        chalk.hex(T.green)(
+          `  ✔ Total: ${totalSaved} variable${totalSaved > 1 ? "s" : ""} saved across ${folders.length} folders`,
+        ),
+      )
+      console.log("")
+    }
+  } else if (selected) {
+    // Process single selected folder
+    const folderLabel = selected.relPath === "." ? null : selected.relPath
+    await processFolder(selected.absPath, isDeepScan, folderLabel)
+  } else {
+    // No folder selected (shouldn't happen)
+    await processFolder(cwd, isDeepScan, null)
+  }
+}
+
+module.exports = {main}