{"_id":"@efthimis.dr/nodelens","_rev":"5-6d6d0c3ba27ed6cdaf8df42e2d3dbbd6","name":"@efthimis.dr/nodelens","dist-tags":{"latest":"1.1.2"},"versions":{"1.0.0":{"name":"@efthimis.dr/nodelens","version":"1.0.0","keywords":["node","watcher","restart","dev-tool","nodemon alternative","file-watcher","hot-reload"],"author":{"name":"Efthimis Drolapas"},"license":"MIT","_id":"@efthimis.dr/nodelens@1.0.0","maintainers":[{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"}],"homepage":"https://github.com/efthimis-dr/nodelens","bugs":{"url":"https://github.com/efthimis-dr/nodelens/issues"},"bin":{"nodelens":"bin/nodelens.js"},"dist":{"shasum":"54efd726808684158de3b7b80b747d3f4c95c5a7","tarball":"https://registry.npmjs.org/@efthimis.dr/nodelens/-/nodelens-1.0.0.tgz","fileCount":7,"integrity":"sha512-wxuakY1xTgV94cDKZclyBXarYGpvy02u0+zT88yG2AWw9vioysIwnbS2/r7Hs5n/qS5dMYjjWmrsdwpWCa2wAA==","signatures":[{"sig":"MEUCIQCoo13jCBaKiTWsjhqj1PWlzjORN221Lj0EU9sKUpVe5AIgfHXTR0el/rR1k0+Xb3MjSqaWJZdEejrzyMA5xNpNoVU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31724},"main":"./src/watcher.js","type":"module","engines":{"node":">=18"},"gitHead":"e9eb4ad8697069434b7dd61886d2d5d8f1f54367","scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node ./bin/nodelens.js"},"_npmUser":{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"},"repository":{"url":"git+https://github.com/efthimis-dr/nodelens.git","type":"git"},"_npmVersion":"10.8.2","description":"A lightweight tool that auto-restarts your Node.js server on file changes.","directories":{},"_nodeVersion":"20.18.0","dependencies":{"chokidar":"^4.0.3"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/nodelens_1.0.0_1763775520871_0.5853271480813589","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@efthimis.dr/nodelens","version":"1.0.1","keywords":["node","watcher","restart","dev-tool","nodemon alternative","file-watcher","hot-reload"],"author":{"name":"Efthimis Drolapas"},"license":"MIT","_id":"@efthimis.dr/nodelens@1.0.1","maintainers":[{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"}],"homepage":"https://github.com/efthimis-dr/nodelens","bugs":{"url":"https://github.com/efthimis-dr/nodelens/issues"},"bin":{"nodelens":"bin/nodelens.js"},"dist":{"shasum":"eefb022da3acad290b5d210e7c8c8033b6a9ddc8","tarball":"https://registry.npmjs.org/@efthimis.dr/nodelens/-/nodelens-1.0.1.tgz","fileCount":7,"integrity":"sha512-yLsTGvw6dR196fSWoGl3APwoI6NjvgPMGc5dyEoCcoiAvu64l2TUbalCllW/MelbP6+ZIYOV22ZnPoOHwPVQoQ==","signatures":[{"sig":"MEUCIQDb3v0q8HVzEp3U+CH7WglYD5fSBTefZAVKexCsQk/TNAIgCIP8u1CnVHYaeaGmN2HP+dB3VYfUiCyUSi0aCHNswj8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":37143},"main":"./src/watcher.js","type":"module","engines":{"node":">=18"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node ./bin/nodelens.js"},"_npmUser":{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"},"repository":{"url":"git+https://github.com/efthimis-dr/nodelens.git","type":"git"},"_npmVersion":"10.8.2","description":"A lightweight tool that auto-restarts your Node.js server on file changes.","directories":{},"_nodeVersion":"20.18.0","dependencies":{"chokidar":"^4.0.3"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/nodelens_1.0.1_1763853844103_0.5069106293319636","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@efthimis.dr/nodelens","version":"1.1.0","keywords":["monitor","watcher","restart","reload","nodemon alternative"],"author":{"name":"Efthimis Drolapas"},"license":"MIT","_id":"@efthimis.dr/nodelens@1.1.0","maintainers":[{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"}],"homepage":"https://github.com/efthimis-dr/nodelens#readme","bugs":{"url":"https://github.com/efthimis-dr/nodelens/issues"},"bin":{"nodelens":"bin/nodelens.js"},"dist":{"shasum":"811a4d18abcc6c4a71027005fd62a730721b74e8","tarball":"https://registry.npmjs.org/@efthimis.dr/nodelens/-/nodelens-1.1.0.tgz","fileCount":7,"integrity":"sha512-wmQdBSWFtuzPnXPCbH+xZu+WPP/L9o0YigqCa2RfwAFKp5dNh9AiomyKW5XmnhzUXLTKHZd++/rQZFfNdmltjQ==","signatures":[{"sig":"MEQCIBXkvCm04QujGlbzYd7lMaqiRTTCalk2FUG8hm7g6w3fAiAcY5KfE/rZDjXXBYDVcrnMLN2vn7VTZVXPxtEkKvWMrA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39251},"main":"./src/watcher.js","type":"module","engines":{"node":">=18"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node ./bin/nodelens.js"},"_npmUser":{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"},"repository":{"url":"git+https://github.com/efthimis-dr/nodelens.git","type":"git"},"_npmVersion":"10.8.2","description":"A lightweight and simple alternative to nodemon that watches and auto-restarts your entry file on file changes. Originally built for servers.","directories":{},"_nodeVersion":"20.18.0","dependencies":{"chokidar":"^4.0.3","update-notifier":"^7.3.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/nodelens_1.1.0_1764036407881_0.8275517896123605","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@efthimis.dr/nodelens","version":"1.1.1","keywords":["monitor","watcher","restart","reload","nodemon alternative"],"author":{"name":"Efthimis Drolapas"},"license":"MIT","_id":"@efthimis.dr/nodelens@1.1.1","maintainers":[{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"}],"homepage":"https://github.com/efthimis-dr/nodelens#readme","bugs":{"url":"https://github.com/efthimis-dr/nodelens/issues"},"bin":{"nodelens":"bin/nodelens.js"},"dist":{"shasum":"d397f84823f93096775004578031356872ff3258","tarball":"https://registry.npmjs.org/@efthimis.dr/nodelens/-/nodelens-1.1.1.tgz","fileCount":7,"integrity":"sha512-OB4knyyeArAuXCibdhkCs+qHRSWtX30GKZqY1sqiTCZ0+IB08Er5KgU+fuE/yR6zi8G7pPDZa2NJO5+JOyaPgQ==","signatures":[{"sig":"MEQCIBj1Nx+/R4I0PTIelFDVv6j320neR29au8cgmh0Y1K6FAiB6RJfY1fwwlo8A8EMs5yDnAqOVzhbnNe2ngUSn8r5K1Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39292},"main":"./src/watcher.js","type":"module","engines":{"node":">=18"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node ./bin/nodelens.js"},"_npmUser":{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"},"repository":{"url":"git+https://github.com/efthimis-dr/nodelens.git","type":"git"},"_npmVersion":"10.8.2","description":"A lightweight and simple alternative to nodemon that watches and auto-restarts your entry file on file changes. Originally built for servers.","directories":{},"_nodeVersion":"20.18.0","dependencies":{"chokidar":"^4.0.3","update-notifier":"^7.3.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/nodelens_1.1.1_1764064360657_0.7849220951461564","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@efthimis.dr/nodelens","version":"1.1.2","description":"A lightweight and simple alternative to nodemon that watches and auto-restarts your entry file on file changes. Originally built for servers.","type":"module","bin":{"nodelens":"bin/nodelens.js"},"main":"./src/watcher.js","keywords":["monitor","watcher","restart","reload","nodemon alternative"],"author":{"name":"Efthimis Drolapas"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/efthimis-dr/nodelens.git"},"bugs":{"url":"https://github.com/efthimis-dr/nodelens/issues"},"scripts":{"start":"node ./bin/nodelens.js","test":"echo \"Error: no test specified\" && exit 1"},"dependencies":{"chokidar":"^4.0.3","update-notifier":"^7.3.1"},"engines":{"node":">=18"},"_id":"@efthimis.dr/nodelens@1.1.2","homepage":"https://github.com/efthimis-dr/nodelens#readme","_nodeVersion":"20.18.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-Ys6Sv0eNG4kEhW1+lAIrY7GpBrY59JrGQkxjp28DV/5EGuoghh6g277OYX2xNa+OOdzeu4oEJR9Lq1BIrNN+wQ==","shasum":"15f37bbac0f2a82c1dd79e460accaf57fde61ecb","tarball":"https://registry.npmjs.org/@efthimis.dr/nodelens/-/nodelens-1.1.2.tgz","fileCount":7,"unpackedSize":39365,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFa4UVQsquWR6VqqXMa1DodenpHUXqnkQ2ugcwzxhYFhAiEAh5UxVCCk4kuczjyAT+d43IuAXqeQlp506Ch5Hnntf8E="}]},"_npmUser":{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"},"directories":{},"maintainers":[{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/nodelens_1.1.2_1764292160348_0.08799156894040139"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-22T01:38:40.797Z","modified":"2025-11-28T01:09:20.724Z","1.0.0":"2025-11-22T01:38:41.077Z","1.0.1":"2025-11-22T23:24:04.315Z","1.1.0":"2025-11-25T02:06:48.061Z","1.1.1":"2025-11-25T09:52:40.855Z","1.1.2":"2025-11-28T01:09:20.543Z"},"bugs":{"url":"https://github.com/efthimis-dr/nodelens/issues"},"author":{"name":"Efthimis Drolapas"},"license":"MIT","homepage":"https://github.com/efthimis-dr/nodelens#readme","keywords":["monitor","watcher","restart","reload","nodemon alternative"],"repository":{"type":"git","url":"git+https://github.com/efthimis-dr/nodelens.git"},"description":"A lightweight and simple alternative to nodemon that watches and auto-restarts your entry file on file changes. Originally built for servers.","maintainers":[{"name":"efthimis.dr","email":"efthimisdrol2006@gmail.com"}],"readme":"

\r\n \"nodeLens\r\n

\r\n\r\n[![npm version](https://img.shields.io/npm/v/@efthimis.dr%2Fnodelens.svg)](https://www.npmjs.com/package/@efthimis.dr/nodelens)\r\n\r\n# About nodeLens\r\n\r\nA lightweight and simple alternative to nodemon that watches and auto-restarts your entry file on file changes. Originally built for servers.\r\n\r\n# Platform Support\r\n\r\nnodeLens uses [Chokidar](https://github.com/paulmillr/chokidar), so it supports:\r\n\r\n- Windows\r\n- Linux\r\n- macOS\r\n- Docker*\r\n\r\n\\* Docker bind mounts on macOS/Windows depend on Docker Desktop performance.\r\n\r\n# Installation\r\n\r\n## Global (recommended)\r\n\r\n```bash\r\nnpm i -g \"@efthimis.dr/nodelens\"\r\n```\r\n\r\n## Local\r\n\r\n```bash\r\nnpm i \"@efthimis.dr/nodelens\"\r\n```\r\n\r\n## After Installation (optional)\r\n\r\nYou can configure nodelens using the `nodelens config init` command. (more info [here](#nodelens-configuration))\r\n\r\n# Quick Start\r\n\r\n```bash\r\nnodelens \r\n```\r\n\r\n# Project Structure\r\n\r\n```\r\nproject-root/\r\n│ index.js (or any preferred name)\r\n│ .nodelens/\r\n│ ├ nl.config.json (if config is initialized)\r\n│ └ nodelens.txt (if saveLogs is enabled)\r\n```\r\n\r\n# Main Commands\r\n\r\n| Command | Description |\r\n| --------------------- | --------------------- |\r\n| `nodelens help` | Shows help view |\r\n| `nodelens version` | Shows current version |\r\n| `nodelens clear-logs` | Clears nodelens.txt |\r\n\r\n# Runtime Commands\r\n\r\nWhile nodeLens is running, you can run commands in the console:\r\n\r\n| Command | Description |\r\n| ------------- | ---------------------- |\r\n| `rs` | Restarts the server |\r\n| `stop` | Stops nodeLens |\r\n| `status` | Shows watcher status |\r\n| `last-change` | Shows last file change |\r\n| `silent` | Toggles silent mode |\r\n| `help` | Shows runtime help |\r\n| `clear` | Clears the console |\r\n\r\n# Features\r\n\r\n- Automatic restarts on file changes\r\n- Configurable ignore/watch patterns\r\n- Runtime commands (rs, stop, clear…)\r\n- Clean, readable logs with labels and timestamps\r\n- Logs saving\r\n- Instant restarts (debounced)\r\n- Crash detection\r\n\r\n# nodeLens Configuration\r\n\r\nnodeLens includes an optional configuration file named `nl.config.json`.\r\n\r\n## Config Commands\r\n\r\nYou can manage the config file using:\r\n\r\n```bash\r\nnodelens config init # Creates nl.config.json\r\nnodelens config reset # Resets it to default settings\r\nnodelens config delete # Deletes the config file\r\n```\r\n\r\n## Config Structure\r\n\r\n```json\r\n{\r\n \"watch\": \"all\",\r\n \"ignore\": [\"node_modules\", \".git\", \"dist\", \"build\", \"temp\", \"logs\"],\r\n \"debounceDelay\": 200,\r\n \"restartDelay\": 0,\r\n \"logLabel\": true,\r\n \"logTimestamp\": false,\r\n \"silentLogs\": false,\r\n \"saveLogs\": false\r\n}\r\n```\r\n\r\n## watch\r\n\r\nControls which files/folders nodeLens should monitor.\r\n\r\n- `\"all\"`: Watch everything (default)\r\n- or specify an array of patterns (files/folders/globs/regex)\r\n\r\n```json\r\n\"watch\": [\"src\", \"routes\", \"index.js\"]\r\n```\r\n\r\n## ignore\r\n\r\nControls which files/folders nodeLens should ignore.\r\n\r\n- nodeLens already includes common ignores\r\n- but you can specify your own patterns\r\n\r\n```json\r\n\"ignore\": [\"node_modules\", \"dist\", \".git\"]\r\n```\r\n\r\n## debounceDelay\r\n\r\nMilliseconds to wait after the last file change before restarting the server.\r\n\r\n```json\r\n\"debounceDelay\": 225\r\n```\r\n\r\nUseful for projects that output many files rapidly.\r\n\r\n## restartDelay\r\n\r\nAdditional milliseconds to wait before restarting. (after debounce)\r\n\r\n```json\r\n\"restartDelay\": 0\r\n```\r\n\r\n## logLabel\r\n\r\nShows log labels like `[INFO]`, `[ERROR]`... at the start of a log. (after timestamp)\r\n\r\n```json\r\n\"logLabel\": true\r\n```\r\n\r\nIncluded labels: `[INFO]`, `[ERROR]`, `[WARN]`, `[SUCCESS]`\r\n\r\n## logTimestamp\r\n\r\nShows a timestamp like [HH:MM:SS] at the start of a log. (before label)\r\n\r\n```json\r\n\"logTimestamp\": true\r\n```\r\n\r\n## silentLogs\r\n\r\nHides all logs except `[ERROR]` and `[WARN]`\r\n\r\n```json\r\n\"silentLogs\": true\r\n```\r\n\r\n## saveLogs\r\n\r\nSaves all logs to `.nodelens/nodelens.txt`.\r\n\r\n```json\r\n\"saveLogs\": true\r\n```\r\n\r\n# Links\r\n\r\n- [npm](https://www.npmjs.com/package/@efthimis.dr/nodelens)\r\n- [GitHub](https://github.com/efthimis-dr/nodelens)\r\n- [Report an issue](https://github.com/efthimis-dr/nodelens/issues)\r\n- [Get Support](https://github.com/efthimis-dr/nodelens/discussions)\r\n- [Donate](https://www.paypal.com/donate/?hosted_button_id=K2NBKKED548D4)\r\n\r\n# License\r\n\r\nMIT + Commons Clause
\r\nBy Efthimis Drolapas — © 2025","readmeFilename":"README.md"}