LARAVILT
Laravilt
页面 · Laravilt

Troubleshooting

Fixes for the most common installation and setup problems.

Start with storage/logs/laravel.log and the browser console. Most problems show up in one of them.

Blank page or missing styles

The frontend isn't built, or you're running a stale build.

bash

Check that APP_URL matches the URL you open.

"Page not found" for a Laravilt page / Inertia can't resolve a component

  • Vue: the panel pages must be published. Re-run php artisan vendor:publish --tag=laravilt-panel-views --force, then rebuild.
  • React: pages resolve from vendor/. Run composer install, then rebuild.
  • Make sure LARAVILT_FRONTEND in .env matches your starter kit (vue or react), then run php artisan config:clear.

The installer ran with the wrong stack

Set LARAVILT_FRONTEND correctly and re-run the installer with an explicit stack on a starter kit of that stack:

bash

/admin returns 404

  • The panel provider must be listed in bootstrap/providers.php (the installer adds App\Providers\Laravilt\AdminPanelProvider::class).
  • Run php artisan route:clear and php artisan optimize:clear.
  • The panel ->path() sets the URL prefix.

Login loops or "CSRF token mismatch"

  • APP_URL, SESSION_DOMAIN and the browser URL must agree (same host and scheme).
  • With SESSION_DRIVER=database, the sessions table must exist (php artisan migrate).

A resource doesn't appear in the navigation

  • It must live under app/Laravilt/{Panel}/Resources/{Name}/{Name}Resource.php for auto-discovery.
  • Check canViewAny() / policies. See Authorization.

npm install or the build fails

bash

Use Node.js 20 or newer.

Class "Laravilt..." not found

bash

Still stuck?