TripNova Docs
Troubleshooting

Common Fixes

Most production issues come from wrong environment values, missing permissions, stale caches, disabled PHP extensions, or a web root pointed outside public.

Blank Page Or 500 Error

Check storage/logs, confirm PHP 8.2 extensions, run composer install --no-dev --optimize-autoloader, and clear caches with php artisan optimize:clear. Temporarily use a private staging copy for debugging instead of enabling APP_DEBUG on production.

Missing CSS Or JavaScript

Confirm public/build/manifest.json exists and the domain points to the Laravel public directory. If frontend files were changed, run npm install and npm run build.

Storage Or Cache Permission Errors

Make storage and bootstrap/cache writable by the PHP user. Delete stale files in bootstrap/cache only after taking a backup, then run php artisan optimize.

Email Not Sending

Verify SMTP host, port, encryption, username, password, from address, and provider firewall rules. Many providers require app passwords or verified sender domains.

Payment Status Not Updating

Confirm gateway mode, webhook URL, webhook secret, HTTPS certificate, queue worker, and logs. Sandbox events do not update live records and live events do not update sandbox records.