{"_id":"@1ipluto/health-check-cli","name":"@1ipluto/health-check-cli","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@1ipluto/health-check-cli","version":"1.0.0","description":"A lightweight CLI tool to validate environment variables and check project health.","type":"module","bin":{"health-check":"index.js"},"main":"index.js","scripts":{"start":"node index.js","prepublishOnly":"node --check index.js && node --check utils/envCheck.js && node --check utils/sizeCheck.js"},"keywords":["cli","env","validator","health-check","devtools","nodejs","dotenv","node-modules","developer-tools"],"author":{"name":"Your Name","email":"you@example.com"},"license":"MIT","dependencies":{"chalk":"^5.3.0","commander":"^12.1.0","ora":"^8.0.1"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/1iPluto/health-check-cli.git"},"bugs":{"url":"https://github.com/1iPluto/health-check-cli/issues"},"homepage":"https://1iPluto.github.io/health-check-cli","gitHead":"bc81817ac6dffcd44f6f393d551039b48dc92941","_id":"@1ipluto/health-check-cli@1.0.0","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-egZSO2XmxLgntyOr9M9Uqx2Md8haTHLqqIdBBPvaIhQZjKPdiKAVn2p9iT1Q0gMgeUdT154MtyZrg8NFxVHVtw==","shasum":"a27fe4652201b2203fb22178636ef0d983f32dae","tarball":"https://registry.npmjs.org/@1ipluto/health-check-cli/-/health-check-cli-1.0.0.tgz","fileCount":6,"unpackedSize":18496,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDWUHGiYBle5BNCdB+pDzq/WgQHDOIfUB8Zqk+Zj3jNngIgTfTxWTHVIKb1RJ8/81cDZA1XyNEDJWf3Tet/am6Xjwo="}]},"_npmUser":{"name":"1ipluto","email":"marwansaid0114@gmail.com"},"directories":{},"maintainers":[{"name":"1ipluto","email":"marwansaid0114@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/health-check-cli_1.0.0_1774248906170_0.7098413018209755"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-23T06:55:06.091Z","1.0.0":"2026-03-23T06:55:06.312Z","modified":"2026-03-23T06:55:06.857Z"},"maintainers":[{"name":"1ipluto","email":"marwansaid0114@gmail.com"}],"description":"A lightweight CLI tool to validate environment variables and check project health.","homepage":"https://1iPluto.github.io/health-check-cli","keywords":["cli","env","validator","health-check","devtools","nodejs","dotenv","node-modules","developer-tools"],"repository":{"type":"git","url":"git+https://github.com/1iPluto/health-check-cli.git"},"author":{"name":"Your Name","email":"you@example.com"},"bugs":{"url":"https://github.com/1iPluto/health-check-cli/issues"},"license":"MIT","readme":"# 🩺 health-check-cli\r\n\r\n> A lightweight, zero-config CLI tool for Node.js developers to validate environment variables and inspect project health — right from the terminal.\r\n\r\n[![npm version](https://img.shields.io/npm/v/health-check-cli.svg)](https://www.npmjs.com/package/health-check-cli)\r\n[![npm downloads](https://img.shields.io/npm/dm/health-check-cli.svg)](https://www.npmjs.com/package/health-check-cli)\r\n[![Node Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\r\n[![GitHub Pages](https://img.shields.io/badge/demo-github.io-blue)](https://1iPluto.github.io/health-check-cli)\r\n\r\n---\r\n\r\n## 🌐 Live Demo\r\n\r\n**[View the interactive demo →](https://1iPluto.github.io/health-check-cli)**\r\n\r\n---\r\n\r\n## ✨ Features\r\n\r\n| Command            | Description                                                      |\r\n|--------------------|------------------------------------------------------------------|\r\n| `health-check env` | Validates your `.env` file against all keys in `.env.example`   |\r\n| `health-check size`| Calculates and displays total size of `node_modules`            |\r\n| `health-check all` | Runs all checks and prints a full Project Health Report         |\r\n\r\n- ✅ Detects **missing** and **empty** environment variables\r\n- 📊 Color-coded visual size bar for `node_modules`\r\n- 🌈 Beautiful terminal output with colors and spinners\r\n- 🛡️ Graceful error handling — never crashes on missing files\r\n- ⚡ Built with ES Modules, zero custom build step\r\n\r\n---\r\n\r\n## 📦 Installation\r\n\r\n### From npm (recommended)\r\n\r\n```bash\r\nnpm install -g health-check-cli\r\n```\r\n\r\n### Local development with `npm link`\r\n\r\n```bash\r\ngit clone https://github.com/1iPluto/health-check-cli.git\r\ncd health-check-cli\r\nnpm install\r\nnpm link\r\n```\r\n\r\nTo unlink later:\r\n```bash\r\nnpm unlink -g health-check-cli\r\n```\r\n\r\n---\r\n\r\n## 🚀 Usage\r\n\r\nNavigate to any Node.js project directory and run:\r\n\r\n### Validate Environment Variables\r\n\r\n```bash\r\nhealth-check env\r\n```\r\n\r\n```\r\n✔  DATABASE_URL\r\n✔  JWT_SECRET\r\n⚠  REDIS_URL        (defined but empty)\r\n✖  STRIPE_SECRET    (missing from .env)\r\n\r\n✖ 2 issue(s) found  (2/4 variables OK)\r\n```\r\n\r\n**Custom paths:**\r\n\r\n```bash\r\nhealth-check env --example .env.staging --local .env.local\r\n```\r\n\r\n### Check node_modules Size\r\n\r\n```bash\r\nhealth-check size\r\n```\r\n\r\n```\r\n  node_modules Size Report:\r\n\r\n  Path:   /Users/you/my-project/node_modules\r\n  Size:   312.47 MB\r\n  Status: Average size. Consider auditing with `npm ls`.\r\n\r\n  [█████████░░░░░░░░░░░░░░░░░░░░░] 312.47 MB / ~1 GB scale\r\n```\r\n\r\n### Run All Checks at Once\r\n\r\n```bash\r\nhealth-check all\r\n```\r\n\r\n### Get Help\r\n\r\n```bash\r\nhealth-check --help\r\nhealth-check env --help\r\nhealth-check size --help\r\n```\r\n\r\n---\r\n\r\n## ⚙️ Options\r\n\r\n| Command | Option | Default | Description |\r\n|---------|--------|---------|-------------|\r\n| `env` | `--example <path>` | `.env.example` | Path to the example env file |\r\n| `env` | `--local <path>` | `.env` | Path to the local env file to validate |\r\n| `size` | `--dir <path>` | `./node_modules` | Path to the directory to measure |\r\n\r\n---\r\n\r\n## 🗂 Project Structure\r\n\r\n```\r\nhealth-check-cli/\r\n├── index.js                        # Main CLI entry point\r\n├── utils/\r\n│   ├── envCheck.js                 # Env validation logic\r\n│   └── sizeCheck.js                # node_modules size calculation\r\n├── docs/\r\n│   └── index.html                  # GitHub Pages demo site\r\n├── .github/\r\n│   └── workflows/\r\n│       └── pages.yml               # Auto-deploy demo to GitHub Pages\r\n├── package.json\r\n├── LICENSE\r\n└── README.md\r\n```\r\n\r\n---\r\n\r\n## 🛠 Tech Stack\r\n\r\n- **[commander](https://github.com/tj/commander.js)** — CLI argument parsing\r\n- **[chalk](https://github.com/chalk/chalk)** — Terminal string styling\r\n- **[ora](https://github.com/sindresorhus/ora)** — Elegant terminal spinners\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n\r\nContributions, issues and feature requests are welcome!\r\n\r\n1. Fork the repo\r\n2. Create your feature branch: `git checkout -b feat/my-new-feature`\r\n3. Commit your changes: `git commit -m \"feat: add my new feature\"`\r\n4. Push to the branch: `git push origin feat/my-new-feature`\r\n5. Open a Pull Request\r\n\r\n---\r\n\r\n## 📄 License\r\n\r\n[MIT](./LICENSE) — free to use, modify, and distribute.\r\n\r\n---\r\n\r\n<p align=\"center\">Made with ❤️ for the developer community</p>\r\n","readmeFilename":"README.md","_rev":"1-8d29d7a1b1790f296b8ef78e76082d7a"}