README

Optional OAuth social login (Google, GitHub) for Vendra user panels, built on dutchcodingcompany/filament-socialite.

Requiring this package is all it takes to add social login — misaf/vendra-user has no dependency on it. Social buttons render on the login form of the panels listed in config/vendra-socialite.php and only appear once their provider credentials are set.

Features

• Google and GitHub login on configured Filament panels
• Existing-user sign-in by email with optional account registration
• Optional email-domain allow list
• Tenant-aware storage for linked social identities

Requirements

• PHP 8.3+
• Laravel 13
• Filament 5
• misaf/vendra-support
• misaf/vendra-user

Installation

composer require misaf/vendra-socialite
php artisan vendor:publish --tag=vendra-socialite-migrations
php artisan migrate

The service provider registers social login on the configured Filament panels.

Configuration

Publish the package configuration and set the OAuth credentials in config/services.php / .env:

php artisan vendor:publish --tag=vendra-socialite-config

GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=https://example.test/admin/oauth/callback/google

GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_REDIRECT_URI=https://example.test/admin/oauth/callback/github

Optional environment values:

• VENDRA_SOCIALITE_REGISTRATION=true — allow unknown OAuth identities to create an account (default false: only existing users, matched by email, may sign in).
• VENDRA_SOCIALITE_DOMAINS=example.com,foo.com — restrict sign-in by email domain.

Testing

Run the package checks from the package directory:

composer test
composer analyse

License

MIT. See LICENSE.