manta-laravel-flux-cms

Troubleshooting

This page helps you solve common problems with the Manta Laravel Flux CMS package.

Installation Problems

ServiceProvider not found

Problem: Class 'Manta\FluxCMS\FluxCMSServiceProvider' not found

Solution:

  1. Check if the package is correctly installed: 
    composer show manta/laravel-manta-cms
  2. Run composer dump-autoload: 
    composer dump-autoload
  3. Check if the ServiceProvider is correctly registered in config/app.php

Migration Errors

Problem: Table 'manta_routes' already exists

Solution:

  1. Check which migrations have already been executed: 
    php artisan migrate:status
  2. Rollback the migration if necessary: 
    php artisan migrate:rollback --step=1
  3. Run the migration again: 
    php artisan migrate

Command Problems

Command not found

Problem: Command "manta:sync-routes" is not defined

Solution:

  1. Check if the ServiceProvider is correctly registered
  2. Clear the application cache: 
    php artisan cache:clear
php artisan config:clear
  3. Check if the command is registered: 
    php artisan list manta

Sync Routes Command Errors

Problem: Call to undefined method Route::getRoutes()

Solution: This can happen if you’re using an older version of Laravel. Make sure you’re using Laravel 12.x.

Problem: SQLSTATE[42S02]: Base table or directory name 'manta_routes' doesn't exist

Solution: Run the migration first:

php artisan migrate

Livewire Problems

Component not found

Problem: Unable to find component: [user-table]

Solution:

  1. Check if the component exists in app/Livewire/
  2. Check the namespace in your component: 
    namespace App\Livewire; // Correct for Livewire 3
  3. Clear the view cache: 
    php artisan view:clear

Livewire Assets not loaded

Problem: Livewire functionality doesn’t work

Solution:

  1. Make sure Livewire assets are published: 
    php artisan livewire:publish --assets
  2. Check if @livewireStyles and @livewireScripts are in your layout: 
    <head>
    @livewireStyles
</head>
<body>
    @livewireScripts
</body>

FluxUI Problems

FluxUI Components not found

Problem: Component [flux:button] not found

Solution:

  1. Check if FluxUI is correctly installed: 
    composer show livewire/flux
  2. Publish FluxUI assets: 
    php artisan flux:install

Styling Problems

Problem: FluxUI components have no styling

Solution:

  1. Check your tailwind.config.js: 
    content: [
    "./vendor/livewire/flux-pro/stubs/**/*.blade.php",
    "./vendor/livewire/flux/stubs/**/*.blade.php",
]
  2. Rebuild your assets: 
    npm run build

Database Problems

Connection Refused

Problem: SQLSTATE[HY000] [2002] Connection refused

Solution:

  1. Check your database configuration in .env
  2. Make sure your database server is running
  3. Test the connection: 
    php artisan tinker
DB::connection()->getPdo();

Permission Denied

Problem: Database permission errors

Solution:

  1. Check database user permissions
  2. Make sure the database user has CREATE, ALTER, DROP rights

Performance Problems

Slow Queries

Solution:

  1. Enable query logging to identify slow queries: 
    DB::enableQueryLog();
// Your code here
dd(DB::getQueryLog());
  2. Add database indexes where needed
  3. Use eager loading for relationships: 
    $users = User::with('roles')->get();

Memory Limit

Problem: Fatal error: Allowed memory size exhausted

Solution:

  1. Increase memory limit in php.ini: 
    memory_limit = 512M
  2. Use chunking for large datasets: 
    User::chunk(100, function ($users) {
    foreach ($users as $user) {
        // Process user
    }
});

Authentication Problems

Route [login] not defined

Problem: RouteNotFoundException: Route [login] not defined

Solution: This happens when authentication redirects are not properly configured.

  1. Automatic fix: Run the install command to configure redirects: 
    php artisan manta:install --force
  2. Manual fix: Add authentication redirects to bootstrap/app.php: 
    ->withMiddleware(function (Middleware $middleware) {
    $middleware->redirectGuestsTo(function ($request) {
        // CMS routes redirect to staff login
        if ($request->is('cms/*') || $request->is('medewerkers/*') || $request->is('bedrijven/*')) {
            return route('flux-cms.staff.login');
        }
           
        // All other routes redirect to account login
        return route('flux-cms.account.login');
    });
})
  3. Clear caches: 
    php artisan route:clear
php artisan config:clear

Route [password.request] not defined

Problem: RouteNotFoundException: Route [password.request] not defined

Solution: This is caused by outdated route references in authentication views.

  1. Check if package is up to date: 
    composer update darvis/manta-laravel-flux-cms
  2. Clear view cache: 
    php artisan view:clear
  3. Re-publish views if customized: 
    php artisan vendor:publish --provider="Manta\FluxCMS\FluxCMSServiceProvider" --tag="views" --force

Staff Login Issues

Problem: Cannot log in to CMS, no staff users exist

Solution:

  1. Check if staff users exist: 
    php artisan tinker
>>> Manta\FluxCMS\Models\Staff::count()
  2. Create a staff user: 
    php artisan manta:create-staff --email=admin@example.com --password=secure-password
  3. Check if staff users are active: 
    php artisan tinker
>>> Manta\FluxCMS\Models\Staff::where('active', true)->count()

Authentication Guard Issues

Problem: Auth guard [staff] is not defined

Solution:

  1. Check auth configuration: 
    php artisan config:show auth.guards.staff
  2. Clear config cache: 
    php artisan config:clear
  3. Verify ServiceProvider is registered: 
    php artisan config:show app.providers | grep FluxCMS

Session Issues

Problem: Users get logged out immediately or sessions don’t persist

Solution:

  1. Check session configuration in .env: 
    SESSION_DRIVER=file
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=null
  2. Clear session files: 
    rm -rf storage/framework/sessions/*
  3. Check session directory permissions: 
    chmod -R 755 storage/framework/sessions/

Cache Problems

Stale Cache

Problem: Changes are not shown

Solution: Clear all caches:

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

Logging & Debugging

Debug Mode

Enable debug mode in .env for more detailed error messages:

APP_DEBUG=true
APP_LOG_LEVEL=debug

Log Files

Check the log files for more information:

tail -f storage/logs/laravel.log

Query Debugging

Debug database queries:

DB::listen(function ($query) {
    Log::info($query->sql, $query->bindings);
});

Getting Help

If you continue to experience problems:

  1. Check the Laravel documentation
  2. Check the Livewire documentation
  3. Check the FluxUI documentation
  4. Create an issue in the package repository
  5. Check existing issues for similar problems