uccellolabs/socialite-uccello-hub

Uccello Hub OAuth2 provider for Laravel Socialite

dev-main 2026-04-14 07:30 UTC

Requires

• php: ^8.2
• laravel/socialite: ^5.0

MIT

README

Laravel Socialite driver for Uccello Hub OAuth2 authentication.

Installation

composer require uccellolabs/socialite-uccello-hub

The service provider is auto-discovered — no manual registration needed.

Configuration

Add to .env:

UCCELLO_HUB_URL=https://hub.uccellolabs.com
UCCELLO_HUB_CLIENT_ID=your-client-id
UCCELLO_HUB_CLIENT_SECRET=your-client-secret
UCCELLO_HUB_REDIRECT="${APP_URL}/auth/uccello-hub/callback"

Add to config/services.php:

'uccello-hub' => [
    'host'          => env('UCCELLO_HUB_URL'),
    'client_id'     => env('UCCELLO_HUB_CLIENT_ID'),
    'client_secret' => env('UCCELLO_HUB_CLIENT_SECRET'),
    'redirect'      => env('UCCELLO_HUB_REDIRECT'),
],

Usage

use Laravel\Socialite\Facades\Socialite;

// Redirect to Uccello Hub
return Socialite::driver('uccello-hub')->redirect();

// Handle the callback
$user = Socialite::driver('uccello-hub')->user();

$user->getId();
$user->getName();
$user->getEmail();
$user->token;
$user->getRaw()['preferred_locale'];
$user->getRaw()['current_team_id'];

User fields

Field	Type	Description
id	integer	Uccello Hub user ID
name	string	Full name
email	string	Email address
preferred_locale	string|null	Language preference (fr, en, …)
current_team_id	integer|null	Active team/workspace

AI skills (Claude Code & Cursor)

This package ships an AI skill that guides Claude and Cursor through the full integration (routes, controller, migration, pitfalls).

The skill is installed automatically the first time any php artisan command runs after composer require. It is copied to .claude/skills/ (Claude Code) and .cursor/rules/ (Cursor) — no manual step needed.

If you use Laravel Boost, the skill is also auto-discovered by boost:install --skills.

Force reinstall:

php artisan uccello-hub:install

Manual publish:

php artisan vendor:publish --tag=claude-skills

License

MIT