Troubleshooting

Find the message you see, then follow the fix. Every message in these pages was produced on purpose in a fresh clone of the template on 2026-10-25, so it is quoted as the code prints it.

Pages

1. Database and local startup
   • npm run migrate fails with Acquire connection error
   • The backend answers 500 and logs relation "..." does not exist
2. Verify failures
   • verify: NOT green - integration specs skipped
   • verify: NOT green - openapi failed
   • verify: NOT green - frontend failed after a diff of types/api.d.ts
   • Code style issues found
   • knip: Unused files, Unused exports or Unused dependencies
3. Boot refusals and warnings
   • The backend refuses to boot in production
   • The frontend exits at startup with Refusing to start
   • A warning you can ignore: A Node.js API is used
4. In the browser
   • The sign-in form says The email service is unavailable
   • /backoffice is a 404
   • An image or script from another site does not load

Related

• Testing - what each verify stage and guard spec checks
• Environment Variables - every variable and what it breaks
• Home - Docs index