Connectio

A local proxy manager — connect and route HTTP requests between your local servers from a single dashboard.

---

Screenshots

Home screen — clean starting point with server controls on the right sidebar

Reorder apps and route rules to control matching priority

Save and load named configurations to switch between project setups

---

Features

• Proxy Apps — Create multiple proxy apps, each pointing to a different local server (e.g. localhost:3001, localhost:4000).
• Wildcard Route Rules — Define path-based routing rules with glob-style wildcards (/api/*, /auth/login). Rules are matched in order, giving you full control over priority.
• Real-Time Request Logs — See every proxied request as it happens: method, path, status code, and response time, streamed live into the UI.
• App Ordering — Reorder proxy apps with up/down controls. Order determines rule priority — if the first app catches /*, it takes precedence.
• Config Management — Save and load named configurations as JSON files. Quickly switch between different project setups without reconfiguring from scratch.
• Collapsible Sidebar — Expand the left nav for full app names or collapse it to icon-only mode for more screen space.
• Cross-Platform — Runs on macOS, Windows, and Linux. Configs are stored in the OS-native user data directory.

How It Works

Connectio runs an Express proxy server on a port you choose (default 8080). When a request comes in, it walks your route rules in order, finds the first match, and proxies the request to the target server using http-proxy-middleware. Each response is logged back to the UI in real time.

Browser / cURL                      Your local servers
       │                                   ▲
       │  GET /api/users                   │
       ▼                                   │
  ┌──────────┐   match: /api/*   ┌─────────────────┐
  │ Connectio│ ───────────────►  │ localhost:3001  │
  │ :8080    │                   │ (API server)    │
  │          │   match: /*       ├─────────────────┤
  │          │ ───────────────►  │ localhost:3000  │
  └──────────┘                   │ (Frontend)      │
                                 └─────────────────┘

Getting Started

Prerequisites

• Node.js v22 or later
• Yarn v1

Install & Run

git clone https://github.com/PulkitBanta/connectio.git
cd connectio
yarn install
yarn start

Quick Start

1. Click + Add App in the left sidebar.
2. Give it a name (e.g. "API Server") and a target URL (e.g. http://localhost:3001).
3. Click the app, then + Add Rule to define a route pattern like /api/*.
4. Set your port in the right sidebar and hit Start Server.
5. Send requests to http://localhost:8080 and watch them get routed and logged in real time.

Build & Release

Local Build

yarn build

Produces platform-specific distributables in the dist/ directory:

Platform	Outputs
macOS	.dmg, .zip
Windows	.nsis, .zip
Linux	.AppImage, .deb

CI / CD

• Build — Every push to main and every PR triggers a build workflow that compiles for all three platforms.
• Release — Trigger the release workflow manually via GitHub Actions, provide a version number, and it builds all platforms, generates a changelog, and creates a GitHub Release with artifacts attached.

Development

yarn dev       # Start with DevTools open
yarn start     # Start without DevTools
yarn lint       # Run ESLint
yarn format     # Run Prettier

Config Storage

Configs are saved as JSON files in the OS user data directory:

OS	Path
macOS	~/Library/Application Support/connectio/configs/
Windows	%APPDATA%/connectio/configs/
Linux	~/.config/connectio/configs/

Tech Stack

• Electron — Desktop shell
• Express 5 — Proxy server
• http-proxy-middleware — Request proxying
• Tailwind CSS — UI styling
• Lucide Icons — Icon set
• electron-builder — Packaging and distribution

License

MIT