run-opendesign

You are starting the OpenDesign preview server. Complete all steps below in order.

Port

Always use 8289.

Steps

1. Detect the platform.

   Run:

   uname -s 2>/dev/null
   

   • If the output starts with MINGW, CYGWIN, or MSYS, or if uname is not found, treat the platform as Windows.
   • Otherwise treat it as POSIX (Linux / macOS / WSL).

2. Check if a server is already running on port 8289.

   POSIX:

   lsof -ti tcp:8289
   

   • If no output, nothing is bound — continue to step 3.
   • If a PID is returned, something is bound to :8289.

   Windows (cmd/PowerShell):

   netstat -ano | findstr LISTENING | findstr :8289
   

   • If no output, nothing is bound — continue to step 3.
   • If output is returned, something is bound to :8289.

   When something is bound on either platform, probe whether it is the OpenDesign server:

   curl -sf -o /dev/null -w "%{http_code}" http://localhost:8289/opendesign/index.html
   

   • If the status code is 200, the OpenDesign server is already running. Skip to step 5.
   • Otherwise, tell the user:

     Port 8289 is in use by another process. Please free the port and try again. Then stop.

3. Detect available runtime. Check in this order:

   POSIX:

   python3 --version 2>/dev/null || python --version 2>/dev/null || node --version 2>/dev/null
   

   Windows:

   python --version 2>$null; if ($LASTEXITCODE -ne 0) { python3 --version 2>$null }; if ($LASTEXITCODE -ne 0) { node --version 2>$null }
   

   Priority order (both platforms):

   • POSIX: python3 → python → node
   • Windows: python → python3 → node (Windows distributions ship as python, not python3)
   • None found → tell the user: "Could not start the preview server — python, python3, and node are all unavailable. Open ./opendesign/index.html manually or install Python." Then stop.

4. Start the server in the background, serving from the project root (not from ./opendesign/).