--- title: 'DF0033: Dev RPC Bridge Failed to Start' description: 'Failed to start dev RPC bridge for "{id}": {reason}' --- ## Message > Failed to start dev RPC bridge for "`{id}`": `{reason}` ## Cause `devframeViteBridge()` (from `@devframes/vite`) could not bring up the bridge dev server that pairs a host-served SPA with devframe's RPC backend, usually because the preferred port is taken with no fallback range, or `def.setup(ctx)` threw. The surrounding Vite dev server keeps running, but the SPA's `__connection.json` lookup fails until the bridge starts. ## Fix - Pin a port via `cli.port` / `cli.portRange` on the definition, or `port` on `devframeViteBridge`. - Inspect `reason` (or the attached `cause`) to fix the setup function or free the port. ## Source - [`packages/vite/src/index.ts`](https://github.com/devframes/devframe/blob/main/packages/vite/src/index.ts): `devframeViteBridge()` logs `DF0033` when port resolution or `createDevServer` throws during `configureServer`.