README

Requirements: PHP ^8.3|^8.4 | Laravel ^12.0 | Filament ^4.0

About This Package

This is an enhanced version of stephenjude/filament-jetstream, which itself is inspired by the original Laravel Jetstream package.

Note: The original Laravel Jetstream package has been discontinued by Laravel, as its functionality has been integrated into Laravel's official starter kits. However, this enhanced version brings back all the powerful features from the original Jetstream package, specifically focusing on team features, mature data handling patterns, and seamless Filament UI integration.

Package Lineage:

Original Laravel Jetstream (discontinued): laravel/jetstream - The inspiration for team features and mature data handling
Filament Implementation: stephenjude/filament-jetstream - Original Filament port
This Enhanced Version: MominAlZaraa/filament-jetstream - Enhanced with complete Jetstream features and patterns

What's Enhanced:

✅ Complete team management features (add, remove, update roles)
✅ Proper invitation flow (register to accept, not auto-registration)
✅ Publishable Action classes with contracts (Jetstream pattern)
✅ Publishable language files with locale-first structure
✅ Enhanced email templates matching Jetstream's UI
✅ Custom validation rules (Role rule matching Jetstream)
✅ Better data handling aligned with Jetstream's mature patterns

Main Purpose

This package is designed for developers who need:

Team/Collaboration Features: Multi-tenant team management with roles, permissions, and invitations - the core feature that made Laravel Jetstream powerful
Filament UI Integration: Native Filament panels and components (not Livewire/Inertia views) - perfect for Filament-based applications
Full Customization: Publishable Action classes and components for complete control - just like the original Jetstream
Production-Ready: Battle-tested features from the original Laravel Jetstream package

Primary Use Case: If you're building a Filament-based application that needs team collaboration features (multi-tenant teams, member invitations, role management), this package provides the same level of functionality that the original Laravel Jetstream offered, but with Filament's beautiful UI components instead of Livewire/Inertia.

Filament Jetstream provides a beautifully designed application starter kit for Laravel with auth, registration, 2FA, session management, API tokens, and comprehensive team support, all implemented with native Filament panels and components.

Skip boilerplate, start building features.

Installation

You can install the package via composer:

composer require mominalzaraa/filament-jetstream

php artisan filament-jetstream:install --teams --api

You can remove the --teams and --api arguments if you don't want those features.

After installation, the package will automatically publish Action classes and email templates that you can customize.

Features

🔐 Authentication

👤 User Profile

👥 Team (Optional)

🔑 API Tokens (Optional)

🌍 Translation-ready

Enhanced Features (Compared to stephenjude/filament-jetstream)

This enhanced version includes comprehensive features inspired by the original Laravel Jetstream package, bringing back the mature team collaboration features and data handling patterns that made Jetstream powerful:

🎨 Complete Publishable Action Classes (Laravel Jetstream Pattern)

All core functionality is now available as publishable Action classes, exactly like the original Jetstream package. Simply publish and modify:

Profile update logic (UpdateUserProfileInformation)
Team invitation handling (InviteTeamMember)
Team member management (AddTeamMember, RemoveTeamMember, UpdateTeamMemberRole)
Team operations (CreateTeam, UpdateTeamName, DeleteTeam with ValidateTeamDeletion)
User deletion (DeleteUser)

This follows the same pattern as the original Laravel Jetstream's Action classes in app/Actions/Jetstream/, providing complete control over business logic.

📧 Enhanced Email Invitation System (Aligned with Laravel Jetstream)

Team invitation emails now intelligently handle both registered and unregistered users, exactly matching the original Jetstream's behavior:

Shows "Create Account" button for users without accounts (when registration is enabled)
Provides clear instructions for both registered and unregistered scenarios
Proper invitation flow: Users must register/login to accept invitations (no auto-registration)
Session-based invitation handling for seamless redirects
Middleware automatically accepts pending invitations after authentication
Handles invitation acceptance for both existing and new users correctly

🔧 Contract-Based Architecture (Laravel Jetstream Pattern)

All actions use Laravel-style contracts, matching the original Jetstream's architecture exactly:

UpdatesUserProfileInformation contract
InvitesTeamMembers contract
AddsTeamMembers contract
RemovesTeamMembers contract (new)
CreatesTeams, UpdatesTeamNames, DeletesTeams contracts
Easily swap implementations without modifying package code

✏️ Easy Profile Field Customization (Enhanced from Jetstream)

Add custom fields to your profile form (like surname, phone, etc.) by simply:

Publishing the Action class
Overriding the getFieldComponents() method
Adding your custom fields
Adding translations in lang/{locale}/filament-jetstream.php

All fields automatically load from your User model - no additional configuration needed! This makes it as easy as the original Jetstream's UpdateUserProfileInformation Action class.

New Methods Available:

getFieldComponents() - Returns form fields without Section wrapper
getSectionHeading() - Returns section title
getSectionDescription() - Returns section description

🛡️ Enhanced Team Management (Jetstream-Level Features)

Complete team management with all the features from the original Jetstream:

Role Validation: Custom Role validation rule (matches Jetstream's Laravel\Jetstream\Rules\Role)
Team Member Role Updates: UpdateTeamMemberRole action class
Team Member Removal: RemoveTeamMember action class with proper authorization
Team Deletion Validation: ValidateTeamDeletion action class prevents deletion of personal teams
Proper Authorization: All actions use Gate checks, matching Jetstream's security model

📦 Publishable Components (Jetstream-Style)

All components, views, Action classes, and language files can be published and customized, following the original Jetstream's publishable stubs pattern:

Action classes in app/Actions/FilamentJetstream/ (similar to Jetstream's app/Actions/Jetstream/)
Email templates in resources/views/vendor/filament-jetstream/emails/
Language files in lang/{locale}/filament-jetstream.php for better locale organization
Full control over every aspect of the package, just like Jetstream allowed

🌍 Publishable Language Files (Locale-First Structure)

All translations are publishable with a locale-first structure (lang/en/filament-jetstream.php), making it easy to:

Customize any existing translation
Add translations for custom fields (like surname, phone, etc.)
Add support for additional languages (just create lang/fr/filament-jetstream.php, etc.)
Manage translations alongside your customizations
Keep all translations for each locale in one place
Automatic merging: Custom translations automatically override package translations

🔄 Improved Team Invitation Flow (Matches Jetstream)

The invitation acceptance flow now matches the original Jetstream's mature handling:

No auto-registration: Users must register first, then accept invitation (proper flow)
Session-based redirects: Invitation ID stored in session during registration/login
Automatic acceptance: Middleware processes pending invitations after authentication
Email alignment: Email template matches Jetstream's structure and messaging
Better error handling: Proper validation and error messages

✅ Data Handling Alignment (Jetstream Patterns)

All data processing follows Jetstream's mature patterns:

Team creation: personal_team always false (matches Jetstream)
User deletion: Properly handles team detachment and owned team deletion
Validation rules: Custom Role rule matches Jetstream's implementation
Event dispatching: All events dispatched correctly (TeamMemberRemoved, TeamMemberUpdated, etc.)

Customization Guide

Publishing Action Classes

To customize core functionality, publish the Action classes:

php artisan vendor:publish --tag=filament-jetstream-actions

This will publish customizable Action classes to app/Actions/FilamentJetstream/:

UpdateUserProfileInformation.php - Customize profile fields and section metadata
InviteTeamMember.php - Customize team invitations with role validation
AddTeamMember.php - Customize adding team members with role validation
RemoveTeamMember.php - Customize removing team members (new)
UpdateTeamMemberRole.php - Customize team member role updates (new)
CreateTeam.php - Customize team creation
UpdateTeamName.php - Customize team updates
DeleteTeam.php - Customize team deletion
ValidateTeamDeletion.php - Customize team deletion validation (new)
DeleteUser.php - Customize user deletion with team handling

Customizing Profile Fields

To add custom fields like surname to your profile form:

Publish the Action class and language files (if not already done):

php artisan vendor:publish --tag=filament-jetstream-actions
php artisan vendor:publish --tag=filament-jetstream-lang

Add the translation in lang/en/filament-jetstream.php:

'form' => [
    'name' => ['label' => 'Name'],
    'surname' => ['label' => 'Surname'],  // Add your custom field translation
    'email' => ['label' => 'Email'],
    // ... other fields
],

Edit app/Actions/FilamentJetstream/UpdateUserProfileInformation.php:

public function getFieldComponents(): array
{
    return [
        // ... existing fields ...
        TextInput::make('name')
            ->label(__('filament-jetstream::default.form.name.label'))
            ->string()
            ->maxLength(255)
            ->required(),
        TextInput::make('surname')  // Add your custom field
            ->label(__('filament-jetstream::default.form.surname.label'))  // Use translation
            ->string()
            ->maxLength(255),
        TextInput::make('email')
            ->label(__('filament-jetstream::default.form.email.label'))
            ->email()
            ->required(),
    ];
}

Add the field to your User model's $fillable array:

protected $fillable = [
    'name',
    'email',
    'surname',  // Add your custom field
    // ...
];

That's it! The field will automatically load from your User model and save when the form is submitted. The translation will be used automatically.

Publishing Email Templates

To customize email templates:

php artisan vendor:publish --tag=filament-jetstream-email-templates

This publishes templates to resources/views/vendor/filament-jetstream/emails/ where you can customize the team invitation email and other email templates.

Publishing Language Files

To customize translations and add translations for custom fields:

php artisan vendor:publish --tag=filament-jetstream-lang

This publishes language files to lang/{locale}/filament-jetstream.php (e.g., lang/en/filament-jetstream.php) for better locale organization. You can:

Customize any existing translation
Add translations for custom fields (like surname, phone, etc.)
Add support for additional languages by creating new locale files

Example: Adding Custom Field Translations

After publishing the language files, edit lang/en/filament-jetstream.php:

return [
    'form' => [
        'name' => ['label' => 'Name'],
        'surname' => ['label' => 'Surname'],  // Add your custom field
        'phone' => ['label' => 'Phone Number'],  // Add another custom field
        'email' => ['label' => 'Email'],
        // ... other fields
    ],
    // ... rest of translations
];

Then use it in your Action class:

TextInput::make('surname')
    ->label(__('filament-jetstream::default.form.surname.label'))

Adding New Languages:

Publish the language files: php artisan vendor:publish --tag=filament-jetstream-lang
Copy lang/en/filament-jetstream.php to lang/your-locale/filament-jetstream.php (e.g., lang/fr/filament-jetstream.php)
Translate all values in the file
The package will automatically use the correct locale based on your app's locale setting

Translation File Structure:

The published files use a locale-first structure:

lang/en/filament-jetstream.php - English translations
lang/fr/filament-jetstream.php - French translations
lang/es/filament-jetstream.php - Spanish translations
lang/el/filament-jetstream.php - Greek translations
etc.

This structure makes it easier to manage multiple locales and keeps all translations for a locale together.

How It Works:

Custom translations from lang/{locale}/filament-jetstream.php automatically override package translations
Package translations are used as fallback for any missing keys
No configuration needed - just publish and customize!
The translation loader automatically merges your customizations with package defaults

Usage & Configurations

Configuring the User Profile

use \App\Models\User;
use Filament\Jetstream\JetstreamPlugin;
use Illuminate\Validation\Rules\Password;

...
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(),
    )

Configuring Team features

use \Filament\Jetstream\Role;
use Filament\Jetstream\JetstreamPlugin;
use Illuminate\Validation\Rules\Password;
use \Filament\Jetstream\Models\{Team,Membership,TeamInvitation};

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

Configuring API features

use Filament\Jetstream\JetstreamPlugin;
use Illuminate\Validation\Rules\Password;
use \Filament\Jetstream\Role;
use \Filament\Jetstream\Models\{Team, Membership, TeamInvitation};

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

Installing the Profile feature

Publish profile migrations

Run the following command to publish the profile migrations.

php artisan vendor:publish \
  --tag=filament-jetstream-migrations \
  --tag=passkeys-migrations \
  --tag=filament-two-factor-authentication-migrations

Add profile feature traits to the User model

Update the App\Models\User model:

...
use Filament\Jetstream\HasProfilePhoto;
use Filament\Models\Contracts\HasAvatar;
use Spatie\LaravelPasskeys\Models\Concerns\HasPasskeys;
use \Filament\Jetstream\InteractsWIthProfile;

class User extends Authenticatable implements  HasAvatar, HasPasskeys
{
    ...
    use InteractsWIthProfile;

    protected $hidden = [
        ...
        'two_factor_recovery_codes',
        'two_factor_secret',
    ];

    protected $appends = [
        ...
        'profile_photo_url',
    ];
}

Installing the Team Features

Publish team migration

Run the following command to publish the team migrations.

php artisan vendor:publish --tag=filament-jetstream-team-migration

Add team feature traits to User model

Update App\Models\User model to implement 'Filament\Models\Contracts\HasTenants' and use Filament\Jetstream\InteractsWithTeams trait.

...
use Filament\Jetstream\InteractsWithTeams;
use Filament\Models\Contracts\HasTenants;

class User extends Authenticatable implements  HasTenants
{
    ...
    use InteractsWithTeams;
}

Installing the API Features

Publish team migration

Run the following command to publish the team migrations.

php artisan vendor:publish --tag=filament-jetstream-team-migration

Add api feature trait to User model

Update App\Models\User model to use Laravel\Sanctum\HasApiTokens trait.

...
use \Laravel\Sanctum\HasApiTokens;

class User extends Authenticatable 
{
    use HasApiTokens;
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Key Differences from stephenjude/filament-jetstream

Feature	stephenjude/filament-jetstream	This Enhanced Version	Original Laravel Jetstream
Action Classes	Logic embedded in components	✅ Complete publishable Action classes with contracts	✅ Publishable Action classes
Profile Customization	Hardcoded fields	✅ Easy field addition via `getFieldComponents()`	✅ Customizable via Action classes
Email Invitations	Basic email, auto-registration	✅ Smart emails with proper registration flow	✅ Handles registered/unregistered users
Invitation Flow	Auto-creates users	✅ Users must register/login (Jetstream pattern)	✅ Proper registration flow
Team Member Management	Basic add/remove	✅ Full CRUD: Add, Remove, Update Role	✅ Complete team member management
Role Validation	Basic validation	✅ Custom `Role` rule (matches Jetstream)	✅ `Laravel\Jetstream\Rules\Role`
Team Deletion	Direct deletion	✅ Validation action prevents personal team deletion	✅ Proper validation
Customization	Limited	✅ Full control via publishable files	✅ Extensive publishable stubs
Architecture	Direct implementation	✅ Contract-based (Laravel-style)	✅ Contract-based architecture
Team Features	Basic implementation	✅ Enhanced with Jetstream patterns	✅ Comprehensive team management
Language Files	Package-only	✅ Publishable with locale-first structure	✅ Publishable translations
Translation System	Standard Laravel	✅ Custom loader merges translations	✅ Standard Laravel
Data Handling	Basic	✅ Mature patterns matching Jetstream	✅ Production-ready patterns

Why This Enhanced Version?

The original Laravel Jetstream was discontinued because its features were integrated into Laravel's starter kits. However, if you need:

Team collaboration features with Filament UI (not Livewire/Inertia)
The same level of customization that Jetstream provided
Publishable Action classes for complete control
Production-ready team management features
Mature data handling patterns from the original Jetstream
Proper invitation flows (register to accept, not auto-registration)
Complete team member management (add, remove, update roles)
Publishable translations with locale-first structure

Then this enhanced version is the perfect solution, bringing Jetstream's powerful features and mature patterns to the Filament ecosystem.

What Makes This Enhanced Version Different?

Complete Feature Parity: All team management features from Jetstream are implemented
Proper Data Handling: Follows Jetstream's mature patterns for invitations, team creation, and member management
Enhanced Customization: More publishable components than the original stephenjude version
Translation Support: Publishable language files with automatic merging
Better Architecture: All actions use contracts, making it easy to swap implementations
Production-Ready: Battle-tested patterns from the original Jetstream package

Migration from stephenjude/filament-jetstream

If you're using the original stephenjude/filament-jetstream package, you can easily migrate:

Backward Compatible: The API remains the same - all existing code will work without changes
Publish Action Classes: Start customizing by publishing Action classes:
```
php artisan vendor:publish --tag=filament-jetstream-actions
```

Publish Language Files: Get full translation control:

php artisan vendor:publish --tag=filament-jetstream-lang

Customize as Needed: All enhancements are backward compatible - you can customize gradually
No Breaking Changes: Your existing configuration and code will continue to work
Enhanced Features: Immediately benefit from improved team invitation flow and better data handling

Important Note on Team Invitations: The invitation flow has been enhanced to match Jetstream's pattern. Users must now register/login before accepting invitations (no auto-registration). This is more secure and follows best practices. Existing invitations will continue to work, but new invitations will follow the enhanced flow.

Coming from Laravel Jetstream?

If you're familiar with the original Laravel Jetstream package and want the same features but with Filament UI:

Same Concepts: Action classes, contracts, and publishable stubs work the same way
Filament UI: Instead of Livewire/Inertia views, you get native Filament components
Team Features: All the team collaboration features you're used to, now in Filament
Easy Migration: The patterns are familiar - just with Filament's component system

Credits

This enhanced package builds upon the excellent work of:

Laravel Jetstream (discontinued): laravel/jetstream - The original inspiration for team features and Action class patterns
Filament Implementation: stephenjude - stephenjude/filament-jetstream - Original Filament port
Laravel Framework: taylorotwell and the Laravel team
Enhanced Version: Momin Al Zaraa - MominAlZaraa/filament-jetstream - Enhanced with complete Jetstream features and patterns
All Contributors

Special Thanks

This package brings together the best of both worlds:

Laravel Jetstream's mature team collaboration features and architecture patterns
Filament's modern, beautiful UI components and developer experience
stephenjude's initial Filament implementation

The result is a powerful, customizable starter kit that gives you Jetstream's team features with Filament's UI.

Contact

For issues, questions, or contributions:

GitHub Issues: https://github.com/MominAlZaraa/filament-jetstream/issues
Email: support@mominpert.com
Repository: https://github.com/MominAlZaraa/filament-jetstream

License

The MIT License (MIT). Please see License File for more information.

mominalzaraa / filament-jetstream

Maintainers

Details

README

About This Package

Main Purpose

Installation

Features

🔐 Authentication

👤 User Profile

👥 Team (Optional)

🔑 API Tokens (Optional)

🌍 Translation-ready

Enhanced Features (Compared to stephenjude/filament-jetstream)

🎨 Complete Publishable Action Classes (Laravel Jetstream Pattern)

📧 Enhanced Email Invitation System (Aligned with Laravel Jetstream)

🔧 Contract-Based Architecture (Laravel Jetstream Pattern)

✏️ Easy Profile Field Customization (Enhanced from Jetstream)

🛡️ Enhanced Team Management (Jetstream-Level Features)

📦 Publishable Components (Jetstream-Style)

🌍 Publishable Language Files (Locale-First Structure)

🔄 Improved Team Invitation Flow (Matches Jetstream)

✅ Data Handling Alignment (Jetstream Patterns)

Customization Guide

Publishing Action Classes

Customizing Profile Fields

Publishing Email Templates

Publishing Language Files

Usage & Configurations

Configuring the User Profile

Configuring Team features

Configuring API features

Existing Laravel projects

Installing the Profile feature

Publish profile migrations

Add profile feature traits to the User model

Installing the Team Features

Publish team migration

Add team feature traits to User model

Installing the API Features

Publish team migration

Add api feature trait to User model

Testing

Changelog

Contributing

Security Vulnerabilities

Key Differences from stephenjude/filament-jetstream

Why This Enhanced Version?

What Makes This Enhanced Version Different?

Migration from stephenjude/filament-jetstream

Coming from Laravel Jetstream?

Credits

Special Thanks

Contact

License