#FilaTeams

Team management plugin for Filament 5. This is the exact implementation of Laravel 13 Starter Kit Teams functionality, just in Filament.

Adds full team functionality — creating teams, switching between them, inviting members, managing roles — wired into Filament's panel with zero configuration on your part.

---

#Package Demo

Here's a 7-minute YouTube video with package demo.

For reference, I also have a 33-minute video course on Laravel 13 Teams customizations.

---

#Screenshots

---

---

---

#Requirements

• PHP 8.2+
• Laravel 12 or 13
• Filament 5

This package is designed to be installed on a fresh Filament project, right after filament:install --panels. It creates its own database tables and takes over the panel's tenancy system, so it's best to set it up before building your resources and pages on top.

---

#Installation

#1. Install via Composer

composer require laraveldaily/filateams

#2. Update your User model

Add the HasTeamMembership interface and HasTeams trait:

use LaravelDaily\FilaTeams\Concerns\HasTeams;
use LaravelDaily\FilaTeams\Contracts\HasTeamMembership;

class User extends Authenticatable implements HasTeamMembership
{
    use HasTeams;

    // ... rest of your model
}

#3. Register the plugin in your PanelProvider

use LaravelDaily\FilaTeams\FilaTeamsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... your existing config
        ->registration() // enable if not already
        ->plugin(FilaTeamsPlugin::make());
}

#4. Run migrations

php artisan migrate

That's it. No additional configuration needed.

---

#What you get

• Automatic personal team — when a user registers, a personal team ("{name}'s Team") is created automatically
• Team switcher — Filament's built-in tenant switcher lets users switch between their teams
• Create team — available at /admin/new
• Team settings page — at /admin/{team}/settings, with sections for:
  • Updating team name
  • Managing members (change roles, remove members, leave team)
  • Inviting new members by email
  • Deleting the team (non-personal teams only, owner only)
• Email invitations — invited users receive an email with an accept link
• Role-based permissions — Owner, Admin, and Member roles with granular permissions

---

#Roles & Permissions

The built-in roles and permissions can be replaced entirely. Publish the config and point enums.role and enums.permission to your own string-backed enum classes that implement TeamRoleContract and TeamPermissionContract:

// config/filateams.php
'enums' => [
    'role'       => App\Enums\MyTeamRole::class,
    'permission' => App\Enums\MyTeamPermission::class,
],

See src/Contracts/TeamRoleContract.php for the full interface your custom role enum must satisfy.

---

#Invitation flow

1. An Owner or Admin invites a user by email from the team settings page
2. The invited user receives an email with an accept link
3. If they're logged in and the email matches — they're added to the team immediately
4. If they're not logged in — they're redirected to login first, then back to accept
5. Invitations expire after 7 days (configurable)

---

#For existing users

If you install the package on a project that already has users, those users won't have teams yet. Create personal teams for them:

use App\Models\User;
use LaravelDaily\FilaTeams\Actions\CreateTeam;

$action = new CreateTeam;

User::whereDoesntHave('teams')->each(function ($user) use ($action) {
    $action->handle($user, [
        'name' => $user->name . "'s Team",
        'is_personal' => true,
    ]);
});

You can run this in tinker or in a seeder/migration.

---

#Configuration

Publish the config file:

php artisan vendor:publish --tag=filateams-config

This creates config/filateams.php:

return [
    // Override the role and permission enum classes
    'enums' => [
        'role'       => LaravelDaily\FilaTeams\Enums\TeamRole::class,
        'permission' => LaravelDaily\FilaTeams\Enums\TeamPermission::class,
    ],

    // Override model classes if you need to extend them
    'models' => [
        'team'       => LaravelDaily\FilaTeams\Models\Team::class,
        'membership' => LaravelDaily\FilaTeams\Models\Membership::class,
        'invitation' => LaravelDaily\FilaTeams\Models\TeamInvitation::class,
    ],

    // How long invitations are valid
    'invitation' => [
        'expires_after_days' => 7,
    ],

    // Create a personal team when a user registers
    'create_personal_team_on_registration' => true,
];

---

#Translations

To publish the language files to your application:

php artisan vendor:publish --tag=filateams-translations

This copies the files to lang/vendor/filateams/ where you can modify existing translations or add new languages by creating a folder named after the locale (e.g. lang/vendor/filateams/de/filateams.php).

---

#Database schema

The package creates three tables and adds one column:

teams — id, name, slug (unique), is_personal, timestamps, soft_deletes

team_members — id, team_id, user_id, role, timestamps (unique on team_id + user_id)

team_invitations — id, code (unique, 64 chars), team_id, email, role, invited_by, expires_at, accepted_at, timestamps

users — adds current_team_id (nullable foreign key to teams)

This schema matches the Laravel 13 starter kit exactly.

---

#License

MIT