mindori

mindori / port-arranger

Public

Run multiple dev servers without port conflicts - automatic port assignment CLI

www.npmjs.compackageport-arranger cli dev-server developer-tools express fastapi
46
0
100% credibility
Found Feb 03, 2026 at 35 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Port Arranger automatically assigns unique ports to local development servers to avoid conflicts when running multiple projects, offering both command-line and graphical management interfaces.

How It Works

1
😩 Hit Port Clash

You try running two web projects at once, but they fight over the same spot and one fails to start.

2
🔍 Find Port Arranger

You discover a simple tool that automatically gives each project its own unique spot to run.

3
🚀 Launch First Project

Start your project with one easy go, and it smoothly grabs a free spot without any fuss.

4
➕ Add More Projects

Fire up as many more as you want – each one finds its own spot instantly, no conflicts ever.

5
Manage Everything
⌨️
Quick Overview

Check the list anytime to see what's running and stop what you don't need.

🖥️
Visual Dashboard

Open a handy window showing all projects with easy buttons to open or shut them down.

🎉 Perfect Harmony

Now juggle multiple projects effortlessly, staying productive without port headaches.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 35 to 46 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is port-arranger?

Port-arranger is a TypeScript CLI tool that runs multiple dev servers—like npm run dev, vite, or docker compose up—without port conflicts by auto-assigning free ports and injecting them via env vars, flags, or YAML overrides. It detects frameworks such as Next.js, Vite, Express, FastAPI, and handles Docker Compose by parsing docker-compose.yml to remap service ports on the same host. A companion Electron GUI dashboard lets you list, monitor, stop processes, and open browsers to assigned ports with commands like pa run, pa list, pa stop --all, or pa ui.

Why is it gaining traction?

It eliminates manual port hunting when spinning up multiple services simultaneously, like running multiple python scripts or docker containers on the same host, with smart detection that just works for common stacks—no config needed. The GUI provides real-time status for Compose services (running/partial/stopped) and one-click browser opens, beating basic process managers. Devs dig the dry-run mode for testing commands like yarn dev or uvicorn alongside others without collisions.

Who should use this?

Fullstack developers juggling local monorepos with frontend (Vite/Next), backend (FastAPI/Express), and Docker services on one machine. Ideal for teams running multiple docker compose files or python scripts simultaneously in VSCode, avoiding the chaos of killing processes or editing package.json ports mid-debug.

Verdict

Grab it for daily local dev if you run multiple servers—solid docs, tests, and global npm install make it dead simple, despite 46 stars and 1.0% credibility signaling early maturity. Watch for edge cases in heavy Compose setups, but it's a workflow saver today.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.