Build Error (BUILD_ERROR)
There was an error building your project. The gateway returns this error when the project fails to compile during deployment.
Common causes
- TypeScript errors - Type mismatches, missing type definitions, or invalid TypeScript syntax prevent the project from compiling.
- Missing imports - A module or package referenced in the code is not installed or does not exist.
- Invalid route configuration - The
routes.oas.jsonfile contains syntax errors or references policies or handlers that do not exist. - Incompatible dependencies - A package dependency has version conflicts or is not compatible with the Zuplo runtime.
How to access build logs
- Open the Zuplo portal and navigate to the project.
- Check the deployment logs for detailed error messages and stack traces.
- For local development, run the build locally to see the full error output.
How to fix
- Read the error message carefully. Build errors typically include the file name, line number, and a description of the issue.
- Fix any TypeScript compilation errors by checking types and imports.
- Verify that all referenced modules are listed in
package.jsonand properly installed. - Validate the
routes.oas.jsonfile to ensure all handler and policy references are correct.
Run builds locally before deploying to catch errors early. See Local Development for setup instructions.
Related resources
Last modified on