Files
the-nexus/PREVIEW.md
Timmy 35c782ae32
Some checks failed
CI / test (pull_request) Failing after 42s
Review Approval Gate / verify-review (pull_request) Failing after 5s
CI / validate (pull_request) Failing after 39s
feat(#1339): Deploy Nexus to proper URL for preview
ES module imports fail via file:// or raw Forge URLs.
Port 3000 (avoids conflict with L402 on :8080, see #1415).
Three options: ./preview.sh, docker, GitHub Pages.

Triage findings filed as new issues: #1413 #1414 #1415

Fixes #1339
2026-04-13 21:25:55 -04:00

802 B

Nexus Preview

ES module imports fail via file:// or raw Forge URLs. boot.js warns: "Serve over HTTP."

Port 3000 chosen to avoid conflict with L402 endpoint on :8080 (see #1415).

Quick Start

./preview.sh              # http://localhost:3000
./preview.sh docker       # nginx + WS proxy
docker compose up -d nexus-preview nexus-backend

Issues Filed During Triage

  • #1413 — deploy.sh comments reference wrong ports (4200/4201 vs 8765/8766)
  • #1414 — hardcoded VPS IP in app.js HUD status
  • #1415 — port 8080 conflict between preview and L402 endpoint

Files

  • Dockerfile.preview — nginx container
  • preview/nginx.conf — MIME types + WebSocket proxy
  • preview.sh — Python preview server
  • .github/workflows/pages.yml — GitHub Pages auto-deploy