Troubleshooting
Having issues with your Next.js template? Find solutions here.
Quick Fixes
Try these first:
-
Restart Dev Server
# Stop (Ctrl+C) then restart npm run dev -
Clear Cache
rm -rf .next npm run dev -
Reinstall Dependencies
rm -rf node_modules package-lock.json npm install
Common Issues
Installation Problems
- Port already in use
- Installation fails
- Node version incompatible
Build Errors
- Build fails
- TypeScript errors
- Module not found
Runtime Issues
- Pages not found (404)
- Styles not loading
- Images not displaying
- Environment variables not working
Deployment Issues
- Build succeeds locally but fails in production
- Images not loading in production
- Environment variables not working in production
Browse All Solutions
- Common Issues → - Frequently encountered problems
- Debugging Tips → - How to find and fix issues
- FAQ → - Frequently asked questions
Still Need Help?
Can’t find a solution? We’re here to help!
Email Support: support@capricorn.engineering
Include in your email:
- Description of the problem
- Error messages (full text)
- What you’ve already tried
- Screenshots if applicable
- Your environment (OS, Node version)
Response Time: Within 24 hours (usually much faster)
Self-Help Resources
Check Documentation
External Resources
Debug Tools
- Browser DevTools (F12)
- React Developer Tools
- Next.js Error Overlay
Remember: Most issues are solved by restarting the dev server or clearing the cache!
Last updated on