Troubleshooting
Common issues and their solutions to help you get your Founderflow Boilerplate running smoothly.
Common Issues
Build Errors
If you're experiencing build errors, try these solutions:
Terminal
# Clear Next.js cacherm -rf .nextnpm run buildClear node_modules and reinstall:
rm -rf node_modules package-lock.json && npm installCheck for TypeScript errors:
npx tsc --noEmitDatabase Connection Issues
If you're having trouble connecting to your database:
Check MongoDB URI format:
mongodb://localhost:27017/your-databaseEnsure database is accessible and running
Verify connection string includes authentication if required
Check firewall settings for cloud databases
Payment Integration Issues
Troubleshooting payment provider integration:
Verify API keys are correct and active
Check webhook endpoints are properly configured
Ensure proper environment variables are set
Test with test mode before going live
Authentication Issues
Common Clerk authentication problems:
Verify Clerk configuration in dashboard
Check webhook endpoints are working
Ensure proper keys are set in environment variables
Check domain configuration for production
Internationalization Issues
Troubleshooting i18n setup:
Check locale configuration in
lib/config/locales.tsVerify translation files exist in
locales/ directoryEnsure proper routing configuration
Check middleware configuration for locale handling
Debug Mode
Enable debug logging to get more detailed error information:
Terminal
# Enable debug loggingDEBUG=* npm run devThis will show detailed logs for debugging issues
Use specific debug namespaces for targeted debugging
Performance Issues
Bundle Size
Check your bundle size and optimize if needed:
npm run build
Image Optimization
Ensure images are properly optimized:
<Image src="..." alt="..." width={...} height={...} />
Enable Compression
Use gzip compression for better performance:
next.config.js → compress: true
CDN for Static Assets
Use a CDN for faster static asset delivery:
Configure assetPrefix in next.config.js
Getting Help
Documentation
Check the comprehensive documentation for detailed guides and examples.
Browse Documentation →Still Need Help?
If you're still experiencing issues, try these resources: