Troubleshooting
Common issues and solutions for the Infowebplus application.
Build Issues
"Module not found"
Solution: Run npm install to install dependencies.
TypeScript Errors
Solution: Run npm run typecheck to see detailed errors.
Runtime Issues
Content Not Loading
-
Check Sanity configuration:
- Verify
NEXT_PUBLIC_SANITY_PROJECT_IDis set - Verify
NEXT_PUBLIC_SANITY_DATASETis correct - Check Sanity API token
- Verify
-
Check cache:
- Clear cache:
POST /api/cache/clear?all=true - Check cache status:
GET /api/cache/clear
- Clear cache:
Cache Not Working
-
Check Redis connection:
redis-cli ping
# Should return: PONG -
Check environment variables:
ENABLE_REDISshould betruefor RedisREDIS_URLshould be set correctly
-
Check logs for errors
Quote Calculator Not Working
- Verify Sanity quote settings are configured
- Check browser console for errors
- Verify API endpoints are accessible
- Check HubSpot configuration (if using)
Deployment Issues
Vercel Deployment Fails
- Check build logs in Vercel dashboard
- Verify all environment variables are set
- Check Node.js version compatibility
Cloudflare Pages Deployment Fails
- Check build logs in Cloudflare dashboard
- Verify build command is correct
- Check Node.js version (requires 20+)
Performance Issues
Slow Page Loads
- Check cache hit rates
- Verify Redis is working (if enabled)
- Check Sanity API response times
- Review Next.js build output
High API Usage
- Enable caching if not already enabled
- Increase cache TTL for static content
- Review API call patterns
Getting Help
- Check the Documentation Index
- Review API Documentation
- Open an issue on GitHub