Skip to content

easy access to portside (pacts favorite)

Latest
Latest

Choose a tag to compare

View all tags
@letsmakepact letsmakepact released this 04 Sep 17:12
· 34 commits to main since this release
v1.0.0
a6b7bdf

⚓ Portside v1.0.0 — Initial Release

Stop remembering ports. Start naming them.

Portside is a lightweight local reverse proxy and developer cockpit that gives every local service its own clean *.localhost domain without modifying /etc/hosts or installing custom certificate authorities.

Created by pact (GitHub: @letsmakepact · Telegram: @pactwithdevil).

🌟 What's New in v1.0.0

1. Clean *.localhost Routing on Standard Port 80

  • No more port suffixes like :3000 in your address bar.
  • Modern browsers resolve *.localhost directly to your local loopback.
  • Access services cleanly:
    • http://api.localhost/ ➔ :8081
    • http://shop.localhost/ ➔ :3001
    • http://admin.localhost/ ➔ :5173

2. Standalone Cross-Platform Launcher

  • Zero-Terminal Setup: Single native executable for Windows, macOS, and Linux.
  • Automated Startup: Starts the PostgreSQL container, verifies dependencies, and binds to Port 80 automatically.
  • Interactive Console & Snow-Blue Interface:
    • Live ASCII art terminal design framed by active ports.
    • Option to keep running in the foreground with live hotkeys ([o] Open browser, [u] Check updates, [q] Quit).
    • Background daemon mode to free up terminal space.
    • Interactive Run on Startup toggle (switch on/off anytime).

3. Automated Update Tracking

  • Launcher checks GitHub releases every time it runs and automatically streams updates into ~/Portside/updates.
  • Localhost web dashboard alerts developers running manual clones when a new GitHub release is published, providing changelog notes, git pull guidance, and a 1-click launcher download.

4. Guided First-Time Feature Tour

  • Built-in interactive onboarding modal that guides users through port mapping, background monitoring, pinning routes, pausing traffic, and project management.

5. Live Background Port Monitor

  • Real-time socket probing with millisecond latency measurements.
  • Automatic online/offline state change logging and activity feed.

📦 Downloads & Platform Binaries

Operating System Architecture Binary Asset
Windows x86_64 Portside-Launcher.exe
macOS Apple Silicon (M1/M2/M3/M4) Portside-Launcher-darwin-arm64
macOS Intel (x86_64) Portside-Launcher-darwin-amd64
Linux x86_64 Portside-Launcher-linux-amd64
Linux ARM64 Portside-Launcher-linux-arm64

One-Line Terminal Install (macOS & Linux):

curl -fsSL https://raw.githubusercontent.com/letsmakepact/PortSide/main/install.sh | bash
Assets 7
Loading