Troubleshooting

Port Already in Use

# Kill process on port 3000
npx kill-port 3000

# Or use a different port
PORT=3001 npm run dev

Database Connection Error

1. Verify your database is running.
2. Check DATABASE_URL in .env is correct.
3. Test the connection:

npm run db:studio

Build Errors

Clear the Next.js cache and rebuild:

rm -rf .next
npm run build

Module Not Found

Re-install dependencies:

rm -rf node_modules package-lock.json
npm install

Prisma Client Out of Sync

After pulling schema changes, regenerate the client:

npm run db:generate

Environment Variables Not Picked Up

Next.js reads .env at startup. After any change to .env, restart the dev server:

# Stop the server (Ctrl+C), then:
npm run dev

Admin Login Fails

• If you changed the password and forgot it, reset it:

npm run db:reset-admin-password