Troubleshooting

Port Already in Use

If a port is already in use, you can either:

1. Stop the process using that port
2. Change the port in the app's package.json dev script and update .env.local

Database Connection Issues

• Verify PostgreSQL is running: pg_isready
• Check database exists: psql -l | grep zooly2_local
• Verify connection string in .env.local matches your PostgreSQL configuration

AWS/Cognito Issues

• Verify AWS credentials are correct: aws sts get-caller-identity --profile zooly
• Check Cognito User Pool ID and Client ID match your AWS account
• Ensure DynamoDB table exists: aws dynamodb describe-table --table-name zooly-auth-identities --profile zooly

CORS Errors

• Ensure ALLOWED_DOMAINS_CORS in .env.local includes all localhost URLs you're using
• Check that ports match between the app and the CORS configuration

Package Build Issues

• Ensure root tsconfig.json includes path mappings for all packages
• Run npm install in each package directory
• Verify declarationMap and sourceMap are enabled in package tsconfig.json