fix: rename PORT to WATT_ADMIN_PORT to avoid .env collisions (#175)

PORT is a very common env var used by many tools and projects. Using it
as the server port placeholder in watt.json meant any .env file with
PORT set would unintentionally change the admin dashboard port.

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: mcollina

.env.sample

@@ -1,2 +1,2 @@
 PLT_BACKEND_TYPESCRIPT=true
-PORT=4042
+WATT_ADMIN_PORT=4042

lib/start.js

@@ -22,7 +22,7 @@ export async function start (client, selectedRuntime) {
     }
   })
 
-  process.env.PORT = port || 4042
+  process.env.WATT_ADMIN_PORT = port || 4042
 
   const requestRecord = async (mode) => {
     return await request(`${entrypointUrl}/api/record/${selectedRuntime}`, {

test/start.test.ts

@@ -68,7 +68,7 @@ describe('start', () => {
   beforeEach(() => {
     mockServer.started = false
     delete process.env.SELECTED_RUNTIME
-    delete process.env.PORT
+    delete process.env.WATT_ADMIN_PORT
 
     // Default parseArgs result
     parseArgsResult = { values: {} }

watt.json

@@ -2,7 +2,7 @@
   "$schema": "https://schemas.platformatic.dev/wattpm/3.11.0.json",
   "server": {
     "hostname": "127.0.0.1",
-    "port": "{PORT}"
+    "port": "{WATT_ADMIN_PORT}"
   },
   "logger": {
     "level": "info"

web/frontend/playwright.config.ts

@@ -1,6 +1,6 @@
 import { defineConfig, devices } from '@playwright/test'
 
-const PORT = process.env.PORT || '5042'
+const PORT = process.env.WATT_ADMIN_PORT || '5042'
 const baseURL = `http://127.0.0.1:${PORT}`
 const timeout = 60000
 
@@ -21,7 +21,7 @@ export default defineConfig({
     timeout,
     stdout: 'pipe',
     stderr: 'pipe',
-    env: { PORT, INCLUDE_ADMIN: '1', CI: '1' }
+    env: { WATT_ADMIN_PORT: PORT, INCLUDE_ADMIN: '1', CI: '1' }
   },
   timeout
 })