NPM Health Proxy

Stop blindly copy-pasting code. Instantly detect deprecated, stale, or vulnerable NPM packages in any tutorial, documentation, or blog post.

Overview

We've all been there: you follow a tutorial, copy an npm install command, and realize hours later that the library hasn't been updated in 4 years.

NPM Health Check is a Chrome Extension that automatically scans code blocks on any webpage. It checks the live NPM registry and injects a "Health Badge" next to every package, warning you about risks before you install.

---

Key Features

• ** Real-Time Scanning:** Instantly parses DOM elements to find npm, yarn, and pnpm commands.
• ** Smart Caching:** Implements a local caching layer (TTL) to minimize API requests and ensure instant results.
• ** Visual Health Badges:** * ✅ Green: Safe & Up-to-date
  • ⚠️ Yellow: Stale (> 2 years without update)
  • 🚫 Red: Deprecated or Archived
• 🛡️ Performance First: Uses a Concurrency Queue to limit active network requests, preventing browser lag or API rate-limiting.
• 🔒 Privacy Focused: Runs entirely client-side. No data is sent to third-party servers except the public NPM registry.

---

Installation Guide

Since this is a developer tool, you can install it directly from the source code:

1. Clone the Repository

   git clone [https://github.com/Ir-Rafi/NPM-Health-Proxy.git](https://github.com/Ir-Rafi/NPM-Health-Proxy.git)

2. Open Chrome Extensions

   • Open Google Chrome and navigate to chrome://extensions.
   • Or go to Menu (⋮) > Extensions > Manage Extensions.

3. Enable Developer Mode

   • Toggle the "Developer mode" switch in the top-right corner.

4. Load the Extension

   • Click the "Load unpacked" button in the top-left.
   • Select the folder where you cloned this repository.

5. Pin & Play!

   • Pin the extension to your toolbar.
   • Visit any coding tutorial (e.g., Medium, GeeksForGeeks) and hit Scan!

---

Technical Highlights (For Recruiters)

This project was built to solve a real-world developer pain point while demonstrating modern System Design concepts in a browser environment:

• Manifest V3 Architecture: Fully migrated to the latest Chrome extension standard using Service Workers for background tasks.
• Asynchronous Queue Management: Implemented a custom request queue with concurrency limits to handle high-volume parsing without blocking the UI thread.
• Inter-Process Communication (IPC): Orchestrated state management between Content Scripts, Popups, and Service Workers using the Chrome Runtime Messaging API.
• Robust Error Handling: Designed a fail-safe system that gracefully handles network errors, API timeouts, and DOM mutations.

---

Connect with Me

Created by Irfan Rafi.
I love building tools that improve the developer experience.(star the repo if u love it)

---

📄 License

This project is licensed under the MIT License.