Every developer knows the pain:

Error: listen EADDRINUSE: address already in use :::3000

You open a project and something is already squatting on the port. Now you're hunting for PIDs and copy-pasting kill commands. Every. Single. Time.

PortPal ends that.

We've evolved from a simple port list to a full Developer Command Center:

• 📈 Traffic Sparklines: Watch real-time connection activity with beautiful, animated SVG mini-charts natively embedded in your metrics.
• 📋 Historical Event Logging: A dedicated logs page tracks every process start, stop, and connection spike along with timestamps and framework contexts.
• 📦 Categorized Services: PortPal automatically groups active ports into cleanly contained UI cards by project and framework.
• 🗂️ Dev vs. System Isolation: Quickly filter ports by 'Dev Frameworks' or 'Other System Apps', complete with a Kill All panic button.
• 🎨 Windowless Chrome: Frameless application design with integrated native UI controls for a hyper-modern feel.

See every listening port on your machine at a glance — process name, PID, connections, framework detection, and project identification.

Hover over any port and click ✕ to kill it instantly. If PortPal knows the start command, hit ↻ to restart it directly in a new terminal. Dead processes show a "stopped" badge with a persistent restart button.

The crown jewel of PortPal. A D3.js-powered network topology visualization that shows precisely how your services are communicating.

• Drag & Collide simulation for physical manipulation
• Scroll to zoom in and navigate
• Node Caching & Real-time updates without screen flickering
• Framework-colored nodes and connection metrics

PortPal lives quietly in your system tray:

• Traffic light icon immediately alerts you to conflicts and statuses
• A background thread quietly builds a historical log of all backend activity while the window is closed

PortPal isn't just a basic netstat wrapper — it understands what you build:

• Framework Detection — Recognizes React, Vite, Angular, Django, Node, and more via default ports.
• Project Context — Crawls for package.json, Cargo.toml, or go.mod to name your running servers.

# Clone
git clone https://github.com/wisher567/Portpal.git
cd portpal

# Install & Run
npm install
npm run tauri dev

Note: The app will launch with Vite HMR — you can freely edit React components and observe changes instantly alongside the Rust backend watcher.

PortPal auto-detects these frameworks out-of-the-box:

Contributions are heavily welcomed to make PortPal even more intelligent.

1. Fork the repository
2. Create a feature branch: git checkout -b feat/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feat/amazing-feature
5. Open a Pull Request

• 🌐 Expanding supported framework signatures
• 🎨 Theme customization & light mode support
• 📦 Homebrew/Winget verification
• 🧪 Expanding unit and integration tests

This project is licensed under the MIT License — see the LICENSE file for details.