skills.rest
qdhenry
qdhenryCOMMUNITY
Explore all skills by this author →
GitHub

setup-portless

Configures Portless to replace localhost port numbers with stable named .localhost URLs.

1.3k|152|Updated Jun 13, 2025
Search Tags:#dev server#local development#Monorepo#localhost#port conflicts#portless#Nodejs
One-click install
npx skills add https://github.com/qdhenry/Claude-Command-Suite --skill setup-portless
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup-portless
Source: https://github.com/qdhenry/Claude-Command-Suite/tree/main/.claude/skills/setup-portless
Command: npx skills add https://github.com/qdhenry/Claude-Command-Suite --skill setup-portless

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires portless.

What problem does it solve?

Local development with port numbers causes port conflicts, cookie collisions, and confusion when running multiple apps or monorepo services. This Skill configures Portless so each app gets a stable named URL like myapp.localhost:1355 instead of a guessed port number.

Core Features & Use Cases

  • Automated Setup: Verifies Node.js 20+ prerequisites, installs Portless globally, and wraps existing dev scripts with named routes.
  • Monorepo Support: Detects workspaces (pnpm, Turbo, Lerna) and assigns subdomain routes like api.myapp and web.myapp to each package.
  • Use Case: A developer with a Next.js frontend and Express backend in one repo runs the setup, and both services become reachable at web.myapp.localhost:1355 and api.myapp.localhost:1355 with no port coordination.

Quick Start

Ask the AI to set up Portless for this project so the dev server runs on a named .localhost URL instead of a port number.

Frequently Asked Questions about setup-portless

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I replace localhost port numbers with named URLs?▼

Install Portless globally with npm install -g portless, then wrap your dev command: portless myapp next dev. Your app becomes available at myapp.localhost:1355 instead of a numbered port.

How do I set up named local URLs for a monorepo?▼

Wrap each workspace's dev script with a subdomain name, such as portless api.myapp node server.js and portless web.myapp next dev. Each service gets its own route like api.myapp.localhost:1355.

Does Portless work on Windows?▼

No, Portless only supports macOS and Linux. It also requires Node.js version 20 or higher, so older Node versions must be upgraded before installation.

Do I need to manually start the Portless proxy?▼

No, the proxy auto-starts when you run portless <name> <cmd>. You only need portless proxy start manually when configuring a custom port, such as port 80 for clean URLs.

How do I bypass Portless and use the default port?▼

Set the environment variable PORTLESS=0 or PORTLESS=skip to bypass Portless and fall back to the default port behavior. You can also override the proxy port with PORTLESS_PORT.

Related Skills

Explore More Software Engineering Skills→
edlovesjavaedlovesjava

typescript-setup

Automate TypeScript/Node.js project boilerplate with configurable toolchain files.

Community
Intermediate
vercel-labsvercel-labs
10.4k

portless

Replace local port numbers with stable named .localhost domains.

Official
Intermediate
damionrashforddamionrashford
15

mcp-integration

Configure MCP servers in Claude Code plugins via .mcp.json.

Community
Advanced
freedomw1987freedomw1987
2

docker-caddy-elysia-deploy

Deploy Elysia.js and React apps with automated HTTPS via Caddy on Docker.

Community
Advanced