From 404373ff806586e2852269e6383dea759fa7ddd8 Mon Sep 17 00:00:00 2001 From: Caio Pizzol Date: Thu, 5 Mar 2026 12:27:48 -0300 Subject: [PATCH 1/2] fix(docs): log warning when local dev server is unreachable (SD-2144) The docs SuperDocEditor widget silently fell back to unpkg when the local Vite dev server was unavailable. Add console.info/warn messages so developers know which bundle is loaded. Also set strictPort on the Vite dev server so it fails instead of silently binding to another port. --- apps/docs/snippets/components/superdoc-editor.jsx | 14 ++++++++++++-- packages/superdoc/vite.config.js | 1 + 2 files changed, 13 insertions(+), 2 deletions(-) diff --git a/apps/docs/snippets/components/superdoc-editor.jsx b/apps/docs/snippets/components/superdoc-editor.jsx index 2d8e39f47d..0d73ed37a1 100644 --- a/apps/docs/snippets/components/superdoc-editor.jsx +++ b/apps/docs/snippets/components/superdoc-editor.jsx @@ -18,8 +18,18 @@ export const SuperDocEditor = ({ if (isDev) { try { const res = await fetch(`${DEV_DIST_URL}/superdoc.umd.js`, { method: 'HEAD' }); - if (res.ok) return DEV_DIST_URL; - } catch {} + if (res.ok) { + console.info('[SuperDoc Docs] Using local build from', DEV_DIST_URL); + return DEV_DIST_URL; + } + console.warn('[SuperDoc Docs] Local dev server returned', res.status, '— falling back to unpkg'); + } catch (err) { + console.warn( + '[SuperDoc Docs] Local dev server not reachable — falling back to unpkg.', + 'Run `pnpm dev:docs` from the repo root to use your local build.', + err.message, + ); + } } return UNPKG_DIST_URL; diff --git a/packages/superdoc/vite.config.js b/packages/superdoc/vite.config.js index dbba46537f..b31433db85 100644 --- a/packages/superdoc/vite.config.js +++ b/packages/superdoc/vite.config.js @@ -217,6 +217,7 @@ export default defineConfig(({ mode, command }) => { }, server: { port: 9094, + strictPort: true, host: '0.0.0.0', fs: { allow: [ From dd1cf861f2b19e377f266eeb25941d0a95c0634a Mon Sep 17 00:00:00 2001 From: Caio Pizzol Date: Thu, 5 Mar 2026 12:31:42 -0300 Subject: [PATCH 2/2] revert: remove strictPort to allow multiple dev sessions --- packages/superdoc/vite.config.js | 1 - 1 file changed, 1 deletion(-) diff --git a/packages/superdoc/vite.config.js b/packages/superdoc/vite.config.js index b31433db85..dbba46537f 100644 --- a/packages/superdoc/vite.config.js +++ b/packages/superdoc/vite.config.js @@ -217,7 +217,6 @@ export default defineConfig(({ mode, command }) => { }, server: { port: 9094, - strictPort: true, host: '0.0.0.0', fs: { allow: [