Skip to main content

Troubleshooting

Docusaurus treats broken links as errors in production builds. Fix the link or update onBrokenLinks in docusaurus.config.js if you need a temporary bypass.

API Explorer shows an empty spec​

Make sure static/openapi.json exists. If you recently updated the backend, re-run:

npm run sync:backend

Schema diagram is missing​

Ensure docs/database/schema-diagram.svg is present. If not, regenerate it from the backend repo and re-sync assets.

Dev server won’t start​

  • Confirm your Node.js version is supported (18+ recommended).
  • Delete node_modules and re-install dependencies.
  • Run npm run clear to reset the Docusaurus cache.