ServerRoutes & API
Runbook
Route-related debugging and common pitfalls.
Symptom: New route not reachable
- Cause: Route module not registered in
routes/index.tsor path conflict. - Action: Ensure
.route('/', createYourRoutes())is present and restart server.
Symptom: Validation errors on incoming requests
- Cause: Zod schema mismatch or missing
zValidatormiddleware. - Action: Verify the schema in the route module and add
zValidatorto the route chain.
Symptom: RPC client types not updated
- Cause:
routeTree.gen.tsnot regenerated. - Action: Run the docs/build step or script that regenerates the route tree used by the frontend.