portless 0.4.0 → 0.4.1

package/dist/cli.js

@@ -599,6 +599,28 @@ function spawnCommand(commandArgs, options) {
     process.exit(code ?? 1);
   });
 }
+var FRAMEWORKS_NEEDING_PORT = {
+  vite: { strictPort: true },
+  "react-router": { strictPort: true },
+  astro: { strictPort: false },
+  ng: { strictPort: false }
+};
+function injectFrameworkFlags(commandArgs, port) {
+  const cmd = commandArgs[0];
+  if (!cmd) return;
+  const basename2 = path2.basename(cmd);
+  const framework = FRAMEWORKS_NEEDING_PORT[basename2];
+  if (!framework) return;
+  if (!commandArgs.includes("--port")) {
+    commandArgs.push("--port", port.toString());
+    if (framework.strictPort) {
+      commandArgs.push("--strictPort");
+    }
+  }
+  if (!commandArgs.includes("--host")) {
+    commandArgs.push("--host", "127.0.0.1");
+  }
+}
 function prompt(question) {
   const rl = readline.createInterface({
     input: process.stdin,
@@ -891,10 +913,16 @@ portless
   console.log(chalk.cyan.bold(`
   -> ${finalUrl}
 `));
-  console.log(chalk.gray(`Running: PORT=${port} ${commandArgs.join(" ")}
+  injectFrameworkFlags(commandArgs, port);
+  console.log(chalk.gray(`Running: PORT=${port} HOST=127.0.0.1 ${commandArgs.join(" ")}
 `));
   spawnCommand(commandArgs, {
-    env: { ...process.env, PORT: port.toString() },
+    env: {
+      ...process.env,
+      PORT: port.toString(),
+      HOST: "127.0.0.1",
+      __VITE_ADDITIONAL_SERVER_ALLOWED_HOSTS: ".localhost"
+    },
     onCleanup: () => {
       try {
         store.removeRoute(hostname);
@@ -942,6 +970,7 @@ ${chalk.bold("Examples:")}
   portless proxy start                # Start proxy on port 1355
   portless proxy start --https        # Start with HTTPS/2 (faster page loads)
   portless myapp next dev             # -> http://myapp.localhost:1355
+  portless myapp vite dev             # -> http://myapp.localhost:1355
   portless api.myapp pnpm start       # -> http://api.myapp.localhost:1355
 
 ${chalk.bold("In package.json:")}
@@ -956,6 +985,8 @@ ${chalk.bold("How it works:")}
   2. Run your apps - they auto-start the proxy and register automatically
   3. Access via http://<name>.localhost:1355
   4. .localhost domains auto-resolve to 127.0.0.1
+  5. Frameworks that ignore PORT (Vite, Astro, React Router, Angular) get
+     --port and --host flags injected automatically
 
 ${chalk.bold("HTTP/2 + HTTPS:")}
   Use --https for HTTP/2 multiplexing (faster dev server page loads).
@@ -984,7 +1015,7 @@ ${chalk.bold("Skip portless:")}
     process.exit(0);
   }
   if (args[0] === "--version" || args[0] === "-v") {
-    console.log("0.4.0");
+    console.log("0.4.1");
     process.exit(0);
   }
   if (args[0] === "trust") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portless",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Replace port numbers with stable, named .localhost URLs. For humans and agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,6 @@
   "files": [
     "dist"
   ],
-  "packageManager": "pnpm@9.15.4",
   "engines": {
     "node": ">=20"
   },
@@ -25,21 +24,6 @@
     "darwin",
     "linux"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "prepublishOnly": "pnpm build",
-    "pretest": "pnpm build",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "prepare": "husky"
-  },
   "keywords": [
     "local",
     "development",
@@ -60,24 +44,21 @@
     "chalk": "^5.3.0"
   },
   "devDependencies": {
-    "@eslint/js": "^9.39.2",
     "@types/node": "^20.11.0",
     "@vitest/coverage-v8": "^4.0.18",
     "eslint": "^9.39.2",
-    "eslint-config-prettier": "^10.1.8",
-    "husky": "^9.1.7",
-    "lint-staged": "^16.2.7",
-    "prettier": "^3.8.1",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
-    "typescript-eslint": "^8.55.0",
     "vitest": "^4.0.18"
   },
-  "lint-staged": {
-    "*.{ts,js}": [
-      "eslint --fix",
-      "prettier --write"
-    ],
-    "*.{json,md,yml,yaml}": "prettier --write"
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   }
-}
+}

package/README.md

@@ -1,160 +0,0 @@
-# portless
-
-Replace port numbers with stable, named .localhost URLs. For humans and agents.
-
-```diff
-- "dev": "next dev"              # http://localhost:3000
-+ "dev": "portless myapp next dev"  # http://myapp.localhost:1355
-```
-
-## Quick Start
-
-```bash
-# Install
-npm install -g portless
-
-# Start the proxy (once, no sudo needed)
-portless proxy start
-
-# Run your app (auto-starts the proxy if needed)
-portless myapp next dev
-# -> http://myapp.localhost:1355
-```
-
-> The proxy auto-starts when you run an app. You can also start it explicitly with `portless proxy start`.
-
-## Why
-
-Local dev with port numbers is fragile:
-
-- **Port conflicts** -- two projects default to the same port and you get `EADDRINUSE`
-- **Memorizing ports** -- was the API on 3001 or 8080?
-- **Refreshing shows the wrong app** -- stop one server, start another on the same port, and your open tab now shows something completely different
-- **Monorepo multiplier** -- every problem above scales with each service in the repo
-- **Agents test the wrong port** -- AI coding agents guess or hardcode the wrong port, especially in monorepos
-- **Cookie and storage clashes** -- cookies set on `localhost` bleed across apps on different ports; localStorage is lost when ports shift
-- **Hardcoded ports in config** -- CORS allowlists, OAuth redirect URIs, and `.env` files all break when ports change
-- **Sharing URLs with teammates** -- "what port is that on?" becomes a Slack question
-- **Browser history is useless** -- your history for `localhost:3000` is a jumble of unrelated projects
-
-Portless fixes all of this by giving each dev server a stable, named `.localhost` URL that both humans and agents can rely on.
-
-## Usage
-
-```bash
-# Basic
-portless myapp next dev
-# -> http://myapp.localhost:1355
-
-# Subdomains
-portless api.myapp pnpm start
-# -> http://api.myapp.localhost:1355
-
-portless docs.myapp next dev
-# -> http://docs.myapp.localhost:1355
-```
-
-### In package.json
-
-```json
-{
-  "scripts": {
-    "dev": "portless myapp next dev"
-  }
-}
-```
-
-The proxy auto-starts when you run an app. Or start it explicitly: `portless proxy start`.
-
-## How It Works
-
-```mermaid
-flowchart TD
-    Browser["Browser\nmyapp.localhost:1355"]
-    Proxy["portless proxy\n(port 1355)"]
-    App1[":4123\nmyapp"]
-    App2[":4567\napi"]
-
-    Browser -->|port 1355| Proxy
-    Proxy --> App1
-    Proxy --> App2
-```
-
-1. **Start the proxy** -- auto-starts when you run an app, or start explicitly with `portless proxy start`
-2. **Run apps** -- `portless <name> <command>` assigns a free port and registers with the proxy
-3. **Access via URL** -- `http://<name>.localhost:1355` routes through the proxy to your app
-
-Apps are assigned a random port (4000-4999) via the `PORT` environment variable. Most frameworks (Next.js, Vite, etc.) respect this automatically.
-
-## HTTP/2 + HTTPS
-
-Enable HTTP/2 for faster dev server page loads. Browsers limit HTTP/1.1 to 6 connections per host, which bottlenecks dev servers that serve many unbundled files (Vite, Nuxt, etc.). HTTP/2 multiplexes all requests over a single connection.
-
-```bash
-# Start with HTTPS/2 -- generates certs and trusts them automatically
-portless proxy start --https
-
-# First run prompts for sudo once to add the CA to your system trust store.
-# After that, no prompts. No browser warnings.
-
-# Make it permanent (add to .bashrc / .zshrc)
-export PORTLESS_HTTPS=1
-portless proxy start    # HTTPS by default now
-
-# Use your own certs (e.g., from mkcert)
-portless proxy start --cert ./cert.pem --key ./key.pem
-
-# If you skipped sudo on first run, trust the CA later
-sudo portless trust
-```
-
-## Commands
-
-```bash
-portless <name> <cmd> [args...]  # Run app at http://<name>.localhost:1355
-portless list                    # Show active routes
-portless trust                   # Add local CA to system trust store
-
-# Disable portless (run command directly)
-PORTLESS=0 pnpm dev              # Bypasses proxy, uses default port
-# Also accepts PORTLESS=skip
-
-# Proxy control
-portless proxy start             # Start the proxy (port 1355, daemon)
-portless proxy start --https     # Start with HTTP/2 + TLS
-portless proxy start -p 80       # Start on port 80 (requires sudo)
-portless proxy start --foreground  # Start in foreground (for debugging)
-portless proxy stop              # Stop the proxy
-
-# Options
--p, --port <number>              # Port for the proxy (default: 1355)
-                                 # Ports < 1024 require sudo
---https                          # Enable HTTP/2 + TLS with auto-generated certs
---cert <path>                    # Use a custom TLS certificate (implies --https)
---key <path>                     # Use a custom TLS private key (implies --https)
---no-tls                         # Disable HTTPS (overrides PORTLESS_HTTPS)
---foreground                     # Run proxy in foreground instead of daemon
-
-# Environment variables
-PORTLESS_PORT=<number>           # Override the default proxy port
-PORTLESS_HTTPS=1                 # Always enable HTTPS
-PORTLESS_STATE_DIR=<path>        # Override the state directory
-
-# Info
-portless --help                  # Show help
-portless --version               # Show version
-```
-
-## State Directory
-
-Portless stores its state (routes, PID file, port file) in a directory that depends on the proxy port:
-
-- **Port < 1024** (sudo required): `/tmp/portless` -- shared between root and user processes
-- **Port >= 1024** (no sudo): `~/.portless` -- user-scoped, no root involvement
-
-Override with the `PORTLESS_STATE_DIR` environment variable if needed.
-
-## Requirements
-
-- Node.js 20+
-- macOS or Linux