Skip to content

Repository files navigation

PortDesk 🚀

PortDesk is a fast, lightweight, AI-crafted native desktop port manager for developers built with Tauri v2, React 19, TypeScript, and Rust. It provides real-time visualization, framework & runtime detection, instant process administration, and public tunneling for developer ports on Windows.

PortDesk Dark Aesthetic


✨ Features

  • Native Win32 High Performance: Directly queries Windows IP tables (GetExtendedTcpTable & GetExtendedUdpTable) via Rust with zero overhead.
  • 🎯 Framework & Runtime Detection: Auto-detects Next.js, Vite, NestJS, Express, Angular, Vue, Nuxt, React, SvelteKit, FastAPI, Django, Flask, Spring Boot, PostgreSQL, MySQL, Redis, MongoDB, Docker, and WSL2.
  • 🔍 Command Palette (Ctrl + K / Cmd + K): Raycast/Linear-style command launcher with keyboard navigation (, , Enter, Escape).
  • ☁️ Cloudflare Tunnel Integration: One-click public HTTPS tunneling (https://*.trycloudflare.com) via cloudflared with automatic fallback to @cloudflare/cloudflared.
  • 🔒 Local HTTPS Proxy: Instantly proxy local HTTP ports over local SSL (https://localhost:<port>).
  • 🐳 Docker & WSL2 Support: Identifies containerized processes and allows 1-click Docker container restarts directly from the app.
  • 🛡️ Dev Auto-Kill & Collision Resolver: Auto-terminates stale zombie processes occupying dev ports (e.g. 3000, 5173).
  • 🎨 Minimalist Obsidian Dark Theme: Vercel/Linear-inspired dark interface with custom frameless window titlebar.
  • ⭐️ Favorites, Custom Aliases & Workspaces: Mark favorite ports, assign custom labels (e.g., Frontend, API Gateway), and group ports into project Workspaces.
  • 💾 JSON Configuration Backup: Full export & import of settings, favorites, aliases, and workspaces.
  • 🔔 System Tray Integration: Background tray menu for quick port actions and status.

🛠️ Tech Stack


🚀 Getting Started

Prerequisites

Development Setup

  1. Clone the repository:

    git clone https://github.com/GnzaDev/PorDesk.git
    cd PorDesk
  2. Install dependencies:

    npm install
  3. Run in development mode:

    npm run tauri dev
  4. Build for production:

    npm run tauri build

🎹 Global Shortcuts

Shortcut Action
Ctrl + K / Cmd + K Open Command Palette & Search
F5 / Ctrl + R Force Refresh Port List
Escape Deselect Port / Close Modals

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details on code style, conventional commits, and how to submit pull requests.


📜 License

PortDesk is open-source software licensed under the MIT License.

About

Landing Page - PortDesk

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages