Why
New contributors will run into common issues such as missing env vars, database connectivity, Prisma schema mismatches, and health-check failures. A focused troubleshooting guide would reduce onboarding friction.
Acceptance criteria
- Cover the most common local setup failures.
- Include symptoms, root causes, and fix steps.
- Link the guide from the README and setup documentation.
Why
New contributors will run into common issues such as missing env vars, database connectivity, Prisma schema mismatches, and health-check failures. A focused troubleshooting guide would reduce onboarding friction.
Acceptance criteria