Install Laravel and Filament

In this lesson, we will look at Laravel and Filament installation. You can skip this lesson if you already know how to install Laravel and Filament.

Laravel Installation

The simplest way to install Laravel is to follow the official documentation. We will use the Laravel installer to create a new project.

laravel new Filament-CRM-Course

This will generate a fresh Laravel installation in a Filament-CRM-Course directory. You can change the name of the project to whatever you want.

Don't forget to set your database credentials in the .env file.

Filament Installation

Next on our list is Filament. We will use Composer to install Filament.

composer require filament/filament

This will install the Filament package in your Laravel project. Next, we need to install Filament Panels:

php artisan filament:install --panels

Once that is done, we can visit our project in the browser like so:

http://filament-crm-course.test/admin/login (don't forget to change the domain to match your project's domain)

Logging Into Filament

To log in, we need to create a user. But before we do that, Filament asks us to add FilamentUser to our User Model:

app/Models/User.php

use Filament\Models\Contracts\FilamentUser;
use Filament\Panel;
use Illuminate\Foundation\Auth\User as Authenticatable;
 
// ...
 
class User extends Authenticatable implements FilamentUser
{
    // ...
 
    public function canAccessPanel(Panel $panel): bool
    {
        return true; // @todo Change this to check for access level
    }
}

This is required for Filament to manage your User permissions and who can access the admin panel. We have set it to true, allowing everyone to access the admin panel. We will change this later in this Course.

Next, we can define a simple admin user in our DatabaseSeeder.php file:

database/seeders/DatabaseSeeder.php

public function run(): void
{
    User::factory()->create([
        'name' => 'Test Admin',
        'email' => 'admin@admin.com',
    ]);
}

Then run the migrations and seeders:

php artisan migrate --seed

And we should be able to log in with our admin user: (Email: admin@admin.com, Password: password)

That's it! We have Laravel and Filament configured and ready to go. In the next lesson, we will create our first Filament Resource - Customer.