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

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