Troubleshooting

Common Issues

Admin Panel Won't Load

1. Verify the application is running: php artisan serve
2. Check the .env file for correct APP_URL and database credentials
3. Clear caches: php artisan cache:clear && php artisan config:clear && php artisan view:clear
4. Check storage permissions: chmod -R 775 storage bootstrap/cache

Storefront Shows Blank Page

1. Run npm run build to compile frontend assets
2. Check for JavaScript errors in the browser console
3. Verify that php artisan storage:link has been run
4. Check storage/logs/laravel.log for PHP errors

Payment Gateway Not Working

1. Confirm the payment method is set to Active in Settings → Payment Methods
2. Verify API keys are correctly entered in the gateway configuration
3. Check that the gateway extension is active in System → Extensions
4. Review storage/logs/laravel.log for API errors from the gateway

Products Not Showing on Storefront

1. Verify the product Status is Enabled
2. Check the product Visibility is set to Catalog & Search or Catalog Only
3. Confirm the product is assigned to at least one active category
4. Ensure the product has a price and stock quantity greater than zero

Email Notifications Not Sending

1. Navigate to Settings → Email Settings and verify the mail driver configuration
2. If using SMTP, check host, port, username, and password
3. Set the mail driver to Log/Testing temporarily to verify emails are being triggered (check storage/logs/laravel.log)
4. Ensure the "From Email" address is valid and not blocked by the SMTP provider

Pages Return 404

Some admin routes are not yet implemented:

• Storefront Menus (Content module)
• Menu Configuration (System module)
• Data Migration (System module)

These features are planned for a future release.

Performance Optimization

• Use database or redis cache driver for production (configure in .env)
• Rebuild caches after configuration changes: System → Cache Management → Rebuild Selected
• Optimize autoloading: composer dump-autoload --optimize
• Enable route caching: php artisan route:cache
• Enable config caching: php artisan config:cache
• Enable view caching: php artisan view:cache