diff --git a/AGENTS.md b/AGENTS.md index ed08baa..5830bb4 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -28,9 +28,13 @@ Standard commands live in `CONTRIBUTING.md` and `package.json` scripts (`npm run - `npm run dev` runs the Express API (`:3001`) and Vite UI (`:5173`) together; open the UI at http://localhost:5173. API liveness: `GET http://localhost:3001/api/health` → `{"ok":true}`. Default mode is single-user (no login). -- Vite is configured with `server.host: true` and `server.allowedHosts: true` so - `http://127.0.0.1:5173` works (not only IPv6 localhost) and Cursor/cloud +- Vite is configured with `server.host: true`, `server.strictPort: true`, and + `server.allowedHosts: true` so `http://127.0.0.1:5173` works (not only IPv6 + localhost), the port does not silently hop to 5174+, and Cursor/cloud port-forward Host headers are not rejected with 403 (which looks like a blank page). +- `apps/web/index.html` paints a dark `#020617` shell inline before JS/CSS so a + hung module graph never shows a white page. If the embedded preview is still + pure white while Playwright/`curl` see the UI, hard-refresh the preview panel. - Vite prints a "Failed to run dependency scan … monaco-editor/esm/…" warning on startup. It is **non-fatal** — Monaco is installed and the SQL editor works; ignore it. diff --git a/apps/web/index.html b/apps/web/index.html index ac23680..77cd1c3 100644 --- a/apps/web/index.html +++ b/apps/web/index.html @@ -1,10 +1,14 @@ - +