• Intro
• Step 1 - First CRUDProject Initiate
• Generate CRUD
• File upload
• Relationships
• View Resource

If you just wish to learn about Filament, please read their documentation and check their demo repo. It will be faster than following my post.

Intro

I have used quite a few admin or CRUD generator kind of Laravel packages for rapid development in the past. Filament is youngest among them but it has quite a lot of things that I like about.

• open-source and free (unlike Nova or Backpack)
• stay in Laravel ecosystem; TALL stack (unlike Orchid)
• good documentation and active community
• enough form fields to use for any type of project
• easy to use table with filter, sorting
• good support for Eloquent’s relationships
• come with navigation, pages, widgets, charts and notifications
• plenty of plugins (not hundreds or thousands, still pretty good amount)
• mainly it is easy to learn thanks to the documentation, demo project repo and existing plugins

So I have decided to use Filament for my future Laravel projects. This post is my journal/guide/log/notes of my learning and experimenting with Filament. My aim is to use Filament together with other packages I normally use. So my project will have other packages for APIs development, APIs integration, deployment, logging and so on. (I have trouble installing Laravel Module package so I have removed it for now. I will try to install it again and use Filament from Module in future.)

I have setup a Github repo mrlinnth/laravel-filament-starter for my project. If you are someone who prefer to read code instead of text, feel free to visit there instead. I update the README file with short to the point steps that I did.

I am gonna skip the followings in this post 

• Setting up local environment for Laravel project on different OS
• Setting up VS Code for Laravel project on different OS
• Installing and setting up Laravel packages that I usually use

I am not even going to write about installing and setting up Filament. If you are using my repo then it’s already installed. I plan to write separate posts for those how to setup topics in future.

If you want to read and follow this post, you will need to 

1. clone my repo mrlinnth/laravel-filament-starter
2. checkout related branch for each step
3. update .env with your DB info
4. run composer install
5. run npm install
6. run php artisan migrate
7. run php artisan optimize

Step 1 - First CRUD

Branch : steps/01-first-crud

First I want to learn how to develop CRUD pages. I also want to see how Filament handles relationships. I decided to develop a superherodb.com inspired project since I am bored with Blog project.

Requirements

• User can create and update heroes.
• A hero can have many skills.
• A hero can belong to teams.
• A hero can be a leader of a team.

When I have requirements, I decide a DB structure

Project Initiate

Generate model, factory, migration and seed files

php artisan make:model -fms Hero

php artisan make:model -fms Skill

php artisan make:model -fms Team

Generate pivot table migration for hero_team

php artisan make:migration create_hero_team_table 

Update the migration files

      Schema::create(‘heroes’, function (Blueprint $table) {             $table->id();             $table->string(‘name’); // text             $table->text(‘history’); // textarea             $table->string(‘species’); // dropdown             $table->string(‘gender’); // radio button             $table->integer(‘age’); // number             $table->string(‘eye_color’); // color picker           $table->json(‘traits’); // group of checkbox             $table->timestamps();       });

        Schema::create(‘skills’, function (Blueprint $table) {             $table->id();             $table->string(‘name’); // text             $table->foreignId(‘hero_id’)->constrained(); // dropdown             $table->integer(‘power’)->default(50); // number             $table->timestamps();         });

        Schema::create(‘teams’, function (Blueprint $table) {             $table->id();           $table->string(‘name’); // text           $table->text(‘story’); // wysiwyg or rich text editor             $table->foreignId(‘leader_id’)                     ->constrained(‘heroes’)                     ->onUpdate(‘cascade’)                     ->onDelete(‘cascade’);             $table->timestamps();         });

        Schema::create(‘hero_team’, function (Blueprint $table) {             $table->id();             $table->foreignId(‘hero_id’)->constrained();             $table->foreignId(‘team_id’)->constrained();             $table->timestamps();         });

Run Migrate

php artisan migrate

Hero has species and traits attributes. They will be predefined but instead of hard coding them directly at form fields we can use Enum class. Spatie Laravel Enum package is very useful.

Generate and update Enum classes

php artisan make:enum SpeciesEnum

/**  * @method static self human()  * @method static self alien()  * @method static self god()  * @method static self robot()  * @method static self mutant()  * @method static self other()  */ final class SpeciesEnum extends Enum { } php artisan make:enum TraitsEnum

/**  * @method static self intelligence()  * @method static self strength()  * @method static self speed()  * @method static self durability()  * @method static self power()  * @method static self combat()  */ final class TraitsEnum extends Enum { }

Hero.php

   

       

       

       

           

{{ $record->name }}

           

{{ $record->history }}

           

                @foreach ($record->traits as $trait)                    

{{ $trait }}

                @endforeach