README

Requirements: PHP ^8.3 | ^8.4 | ^8.5 · Laravel ^12.0 · Filament ^5.0 (Livewire ^4.0, Tailwind ^4.0)

Enhanced Laravel starter kit built with Filament, inspired by Laravel Jetstream (discontinued). Brings team features, mature data handling, and Filament UI—auth, registration, 2FA, passkeys, session management, API tokens, teams. Skip boilerplate, start building.

Supported: PHP ^8.3–^8.5, Filament ^5.0, Laravel ^12.0, Livewire ^4.0, Tailwind ^4.0 · Deprecated: PHP <8.3, Filament v4 (use v1.x), Laravel <12.

Installation

composer require mominalzaraa/filament-team-guard
php artisan filament-team-guard:install --teams --api

Omit --teams / --api if not needed. Action classes and email templates are published for customization.

Features

• Auth — Login, register, password reset, email verification
• Profile — Photo, info, password, sessions, delete account
• 2FA & passkeys — Embedded TOTP, recovery codes, Spatie Laravel Passkeys. Enable via ->twoFactorAuthentication().
• Cloudflare Turnstile — Optional ->turnstile() on auth + 2FA challenge/recovery. njoguamos/laravel-turnstile; set TURNSTILE_* in .env, run php artisan turnstile:install.
• Teams — Create, invite, roles, member management (add/remove/update role)
• API tokens — Optional Sanctum-style tokens
• i18n — Publishable locale-first language files

Enhanced vs stephenjude/filament-jetstream

• Publishable Action classes (Jetstream pattern): UpdateUserProfileInformation, InviteTeamMember, AddTeamMember, RemoveTeamMember, UpdateTeamMemberRole, CreateTeam, UpdateTeamName, DeleteTeam, ValidateTeamDeletion, DeleteUser — all with contracts.
• Email invitations — Registered/unregistered flow; “Create Account” when needed; session-based redirects; no auto-registration.
• Profile fields — Override getFieldComponents(), getSectionHeading(), getSectionDescription() in published Action; add translations in lang/{locale}/filament-team-guard.php.
• Team management — Custom Role rule, UpdateTeamMemberRole, RemoveTeamMember, ValidateTeamDeletion.
• Publishable — Actions, emails, lang; locale-first translations with merge/override.

Customization

Profile field example: Publish actions + lang → add key in lang/en/filament-team-guard.php → in UpdateUserProfileInformation override getFieldComponents() and add a TextInput::make('surname') (and translation) → add surname to User $fillable.

Configuration (snippets)

Profile (2FA, passkeys, photo, etc.)

JetstreamPlugin::make()
    ->configureUserModel(userModel: User::class)
    ->profilePhoto(condition: fn() => true, disk: 'public')
    ->deleteAccount(condition: fn() => true)
    ->updatePassword(condition: fn() => true, Password::default())
    ->profileInformation(condition: fn() => true)
    ->logoutBrowserSessions(condition: fn() => true)
    ->twoFactorAuthentication(
        condition: fn() => auth()->check(),
        forced: fn() => app()->isProduction(),
        enablePasskey: fn() => Feature::active('passkey'),
        requiresPassword: fn() => app()->isProduction(),
    );

Teams

JetstreamPlugin::make()
    ->teams(condition: fn() => Feature::active('teams'), acceptTeamInvitation: fn($id) => JetstreamPlugin::make()->defaultAcceptTeamInvitation())
    ->configureTeamModels(teamModel: Team::class, roleModel: Role::class, membershipModel: Membership::class, teamInvitationModel: TeamInvitation::class);

API tokens

JetstreamPlugin::make()->apiTokens(condition: fn() => Feature::active('api'), permissions: fn() => ['create','read','update','delete'], menuItemLabel: fn() => 'API Tokens', menuItemIcon: fn() => 'heroicon-o-key');

Existing Laravel projects

• Profile: php artisan vendor:publish --tag=filament-team-guard-migrations --tag=passkeys-migrations → add InteractsWithProfile, HasProfilePhoto, implement HasAvatar & HasPasskeys on User; hide 2FA fields; append profile_photo_url.
• Teams: php artisan vendor:publish --tag=filament-team-guard-team-migration → add InteractsWithTeams, implement HasTenants on User.
• API: Same team migration tag → add HasApiTokens on User.

Package development

Run composer install in the package root for tests. vendor/ is in .gitignore and not distributed; composer require mominalzaraa/filament-team-guard in an app only pulls package source—the app’s Composer resolves Filament once (no duplication). .gitattributes has /vendor export-ignore.

Testing · Changelog · Contributing

• Tests: composer test
• Changelog: CHANGELOG.md
• Contributing: .github/CONTRIBUTING.md

Credits

• Laravel Jetstream (discontinued) — team features & Action pattern
• stephenjude/filament-jetstream — Filament port
• Momin Al Zaraa — this enhanced version · Issues · support@mominpert.com

License: MIT. See LICENSE.md.