fix: use env-var-driven ports in Procfile templates to support multiple worktrees#2539

Merged

ihabadham merged 31 commits intomasterfrom

ihabadham/fix/worktree-port-config

Mar 7, 2026

Commits on Mar 7, 2026

fix: use ${PORT:-3000} in Procfile.dev template to avoid worktree port conflicts
ihabadham
committed
fix: use ${PORT:-N} in Procfile variant templates
ihabadham
committed
feat: add .env.example template for per-worktree port configuration
ihabadham
committed
feat: copy .env.example during generator install
ihabadham
committed
test: assert env-var ports and .env.example in base generator output
ihabadham
committed
docs: document worktree port configuration with .env pattern
ihabadham
committed
feat: add PortSelector for automatic free port detection

ihabadham
and
claude
committed
feat: wire PortSelector into ServerManager before process manager starts

ihabadham
and
claude
committed
docs: update worktree section — auto port detection is now zero-config

ihabadham
and
claude
committed
test: fill coverage gaps in PortSelector and procfile_port

ihabadham
and
claude
committed
test(generator): assert Procfile.dev-prod-assets uses env-var-driven port

ihabadham
and
claude
committed
docs(generator): clarify PORT default differs between Procfile variants

ihabadham
and
claude
committed
docs(process-managers): fix stale process names in Procfile.dev snippet

ihabadham
and
claude
committed
docs(process-managers): warn direct foreman users about PORT injection

ihabadham
and
claude
committed
fix(server_manager): configure ports before printing the access URL banner

ihabadham
and
claude
committed
refactor(port_selector): remove unused WEBPACK_OFFSET and deduplicate method call

ihabadham
and
claude
committed
docs(process-managers): add language tag to fenced code block (MD040)

ihabadham
and
claude
committed
fix(server_manager): rescue NoPortAvailable in configure_ports for clean exit

ihabadham
and
claude
committed
test(server_manager): restore ENV vars instead of deleting in port config context

ihabadham
and
claude
committed
docs(port_selector): document TOCTOU limitation in port_available?

ihabadham
and
claude
committed
fix(generator): add .env to .gitignore so port config is not accidentally committed

ihabadham
and
claude
committed
test(server_manager): clear ENV before each example to prevent order-dependent failures

ihabadham
and
claude
committed
fix(port_selector): probe the unset side in single-ENV branches

ihabadham
and
claude
committed
fix(server_manager): pass auto-detected port to print_server_info in static mode

ihabadham
and
claude
committed
fix: probe Rails and webpack ports independently in find_free_pair

ihabadham
and
claude
committed
fix(server_manager): use procfile_port in run_production_like banner

ihabadham
and
claude
committed
refactor(port_selector): simplify select_ports with ||= pattern

ihabadham
and
claude
committed
fix(base_generator): clarify gitignore section header

ihabadham
and
claude
committed
fix: set PORT before foreman in prod mode, suppress message for user-set ports

ihabadham
and
claude
committed
fix(server_manager): auto-detect free port for prod-assets mode

ihabadham
and
claude
committed
fix(port_selector): check both IPv4 and IPv6 in port_available?

ihabadham
and
claude
committed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

fix: use env-var-driven ports in Procfile templates to support multiple worktrees#2539

fix: use env-var-driven ports in Procfile templates to support multiple worktrees#2539
ihabadham merged 31 commits intomasterfrom
ihabadham/fix/worktree-port-config

Commits on Mar 7, 2026

fix: use ${PORT:-3000} in Procfile.dev template to avoid worktree port conflicts

fix: use ${PORT:-N} in Procfile variant templates

feat: add .env.example template for per-worktree port configuration

feat: copy .env.example during generator install

test: assert env-var ports and .env.example in base generator output

docs: document worktree port configuration with .env pattern

feat: add PortSelector for automatic free port detection

feat: wire PortSelector into ServerManager before process manager starts

docs: update worktree section — auto port detection is now zero-config

test: fill coverage gaps in PortSelector and procfile_port

test(generator): assert Procfile.dev-prod-assets uses env-var-driven port

docs(generator): clarify PORT default differs between Procfile variants

docs(process-managers): fix stale process names in Procfile.dev snippet

docs(process-managers): warn direct foreman users about PORT injection

fix(server_manager): configure ports before printing the access URL banner

refactor(port_selector): remove unused WEBPACK_OFFSET and deduplicate method call

docs(process-managers): add language tag to fenced code block (MD040)

fix(server_manager): rescue NoPortAvailable in configure_ports for clean exit

test(server_manager): restore ENV vars instead of deleting in port config context

docs(port_selector): document TOCTOU limitation in port_available?

fix(generator): add .env to .gitignore so port config is not accidentally committed

test(server_manager): clear ENV before each example to prevent order-dependent failures

fix(port_selector): probe the unset side in single-ENV branches

fix(server_manager): pass auto-detected port to print_server_info in static mode

fix: probe Rails and webpack ports independently in find_free_pair

fix(server_manager): use procfile_port in run_production_like banner

refactor(port_selector): simplify select_ports with ||= pattern

fix(base_generator): clarify gitignore section header

fix: set PORT before foreman in prod mode, suppress message for user-set ports

fix(server_manager): auto-detect free port for prod-assets mode

fix(port_selector): check both IPv4 and IPv6 in port_available?