src/deployment/viteConfig.test.mjs

@@ -0,0 +1,9 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import test from 'node:test'
+
+const configSource = readFileSync(new URL('../../vite.config.ts', import.meta.url), 'utf8')
+
+test('fails fast when the dedicated client development port is occupied', () => {
+  assert.match(configSource, /server:\s*\{\s*strictPort: true,/)
+})

vite.config.ts

@@ -27,6 +27,7 @@ export default defineConfig(({ mode }) => {
       },
     },
     server: {
+      strictPort: true,
       proxy: {
         '/api': {
           target: proxyTarget,