PHPackages                             laravel-uis/socialite-ui - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. laravel-uis/socialite-ui

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

laravel-uis/socialite-ui
========================

A Laravel Socialite UI for the new Laravel Starter Kits

1.0.0(1y ago)114.3k↑18.8%[1 issues](https://github.com/Laravel-Uis/socialite-ui/issues)[1 PRs](https://github.com/Laravel-Uis/socialite-ui/pulls)1MITPHPPHP ^8.2CI failing

Since Mar 4Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/Laravel-Uis/socialite-ui)[ Packagist](https://packagist.org/packages/laravel-uis/socialite-ui)[ Fund](https://paypal.me/joelbutcher)[ GitHub Sponsors](https://github.com/joelbutcher)[ RSS](/packages/laravel-uis-socialite-ui/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelog (2)Dependencies (14)Versions (3)Used By (1)

Laravel Socialite UI
====================

[](#laravel-socialite-ui)

[ ![Build Status](https://github.com/Laravel-Uis/socialite-ui/workflows/tests/badge.svg)](https://github.com/Laravel-Uis/socialite-ui/actions)[ ![Total Downloads](https://camo.githubusercontent.com/6a1643c01d11c0a782de77e028898da5a17c3797abe3cb8ad45e37e7cad9bd3e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f4c61726176656c2d5569732f736f6369616c6974652d7569)](https://packagist.org/packages/Laravel-Uis/socialite-ui)[ ![Latest Stable Version](https://camo.githubusercontent.com/13c692717f73d3654ded6030e1e6b6de59ca332b06d9fa6a4c473594352f6c0a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f4c61726176656c2d5569732f736f6369616c6974652d7569)](https://packagist.org/packages/Laravel-Uis/socialite-ui)[ ![License](https://camo.githubusercontent.com/692391c6eb49b88e36040aaa1c346a53b4cffbcb289862f937f9c0b59292d826/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f4c61726176656c2d5569732f736f6369616c6974652d7569)](https://packagist.org/packages/Laravel-Uis/socialite-ui)Laravel Socialite UI is a third-party Laravel package that connects the dots between Laravel Socialite and the new Laravel Starter Kits. It provides a simple way to add social authentication to your Laravel application.

Laravel Socialite UI supports the new React, Vue, Livewire (Volt) and Livewire (class-components) starter kits.

Note

Laravel Socialite UI is a third-party package and is not officially supported by Laravel.

Getting Started
---------------

[](#getting-started)

We've worked incredibly hard to make it as easy as possible to add support for Laravel Socialite into your starter kit application.

To start using Laravel Socialite UI, create a new composer project using any of the starter kit templates and compile your frontend assets:

**React**

```
laravel new my-app --using=laravel-uis/socialite-ui-react-starter-kit
```

**Vue**

```
laravel new my-app --using=laravel-uis/socialite-ui-vue-starter-kit
```

**Livewire (Volt)**

```
laravel new my-app --using=laravel-uis/socialite-ui-livewire-starter-kit
```

**Livewire (classes)**

```
laravel new my-app --using=laravel-uis/socialite-ui-livewire-starter-kit:dev-components
```

### Screenshots

[](#screenshots)

[![Laravel Socialite UI](./docs/screenshots/login.png)](./docs/screenshots/login.png)

[![Linked Accounts Page](./docs/screenshots/linked-accounts.png)](./docs/screenshots/linked-accounts.png)

Features
--------

[](#features)

Laravel Socialite UI comes pre-configured with a bunch of useful features, ready for your next great idea:

#### **1. "Remember Me" functionality**

[](#1-remember-me-functionality)

Laravel Socialite UI includes a "Remember Me" feature that allows users to stay logged in, even after they close their browser. This setting is enabled by default, but can be disabled in the `config/socialite-ui.php` configuration file, simply remove this line:

```
Features::rememberSession(),
```

#### **2. Global Login**

[](#2-global-login)

Laravel Socialite UI includes a global login feature that allows users to log into your application from any page. This setting is enabled by default, but can be disabled by removing the `Features::globalLogin()` line from your config file.

#### **3. Generate Missing Emails**

[](#3-generate-missing-emails)

Some social providers do not return an email address for the user by default and require additional configuration in order to do so. Laravel Socialite UI includes a feature that generates a unique email address for these users. This setting can be disabled by removing the `Features::generateMissingEmails()` line from your config file.

#### **4. Refresh OAuth Tokens**

[](#4-refresh-oauth-tokens)

Laravel Socialite UI includes a feature that automatically refreshes OAuth tokens when they expire when a user logs into your application. Disable this setting by removing the `Features::refreshOAuthTokens()` line from your config file.

#### **5. Create on login**

[](#5-create-on-login)

If you have opted out of the Global Login feature of Socialite UI, you can still allow new users to be created from the login screen by uncommenting the `Features::createAccountOnFirstLogin(),` line in your config file.

Customization
-------------

[](#customization)

Laravel Socialite UI is highly customizable and can be tailored to suit your application's needs.

#### **1. User model**

[](#1-user-model)

By default, Laravel Socialite UI uses the `App\Models\User` model for authentication and account creation. However, you may wish to use a different model. To do so, you may call the `SocialiteUI::useUserModel` method from the `boot` method of you application's `AppServiceProvider`, passing in the fully qualified class name of your desired model.

```
use SocialiteUI\SocialiteUI;

SocialiteUI::useUserModel(Path\To\Your\User::class);
```

#### **2. Social Account model**

[](#2-social-account-model)

Similarly, you may define a different model to be used for storing the details of linked social accounts by calling the `SocialiteUI::useSocialAccountModel` method from the `boot` method of you application's `AppServiceProvider`.

```
use SocialiteUI\SocialiteUI;

SocialiteUI::useSocialAccountModel(Path\To\Your\SocialAccount::class);
```

#### **3. Customizing the actions**

[](#3-customizing-the-actions)

To keep your codebase clean, Socialite UI uses internal classes to perform specific actions when authenticating a user with a new, or known social account.

However, you are free to override these actions at any point.

Typically, you would call any of these methods within the `boot` method of a service provider.

```
use SocialiteUI\SocialiteUI;

// Customize how Socialite UI generates the redirect URL for a provider
SocialiteUi::generatesProvidersRedirectsUsing(...);

// Customize how Socialite UI resolves users from Socialite
SocialiteUi::resolvesSocialiteUsersUsing(...);

// Customize how Socialite UI creates users from Socialite
SocialiteUi::createUsersFromProviderUsing(...);

// Customize how Socialite UI creates social accounts from Socialite
SocialiteUi::createSocialAccountsUsing(...);

// Customize how Socialite UI updates social accounts from Socialite
SocialiteUi::updateSocialAccountsUsing(...);

// Customize how Socialite UI handles the `Laravel\Socialite\Two\InvalidStateException` when attempting to resolve a user from Socialite.
SocialiteUi::handlesInvalidStateUsing(...);

// Override the callback logic used by Socialite UI to authenticate users.
SocialiteUi::authenticatesOAuthCallbackUsing(...);

// Customize how Socialite UI handles errors when returning from a failed login attempt from a provider.
SocialiteUi::handlesOAuthCallbackErrorsUsing(...);

// Use a custom prompt your users are shown when they attempt to link a new provider from the "Linked Accounts" screen.
SocialiteUi::promptOAuthLinkUsing(...);
```

Contributing
------------

[](#contributing)

Thank you for considering contributing to Socialstream! You can read the contribution guide [here](.github/CONTRIBUTING.md).

Code of Conduct
---------------

[](#code-of-conduct)

In order to ensure that the Laravel development community is welcoming to all, please review and abide by the [Code of Conduct](.github/CODE_OF_CONDUCT.md).

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance56

Moderate activity, may be stable

Popularity30

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~262 days

Total

2

Last Release

178d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/eb6903ee363d9201681e47a2dcbe12148b7d299dd9e37229cad774ecd923fd6e?d=identicon)[joelbutcher](/maintainers/joelbutcher)

---

Top Contributors

[![joelbutcher](https://avatars.githubusercontent.com/u/7163152?v=4)](https://github.com/joelbutcher "joelbutcher (11 commits)")

---

Tags

laraveloauthsocialiteoauth2starter-kitlaravel socialite

###  Code Quality

TestsPest

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/laravel-uis-socialite-ui/health.svg)

```
[![Health](https://phpackages.com/badges/laravel-uis-socialite-ui/health.svg)](https://phpackages.com/packages/laravel-uis-socialite-ui)
```

###  Alternatives

[socialiteproviders/manager

Easily add new or override built-in providers in Laravel Socialite.

42542.0M544](/packages/socialiteproviders-manager)[socialiteproviders/apple

Apple OAuth2 Provider for Laravel Socialite

618.4M8](/packages/socialiteproviders-apple)[andrewdwallo/filament-companies

A comprehensive Laravel authentication and authorization system designed for Filament, focusing on multi-tenant company management.

34450.0k2](/packages/andrewdwallo-filament-companies)[seoda/socialite-apple

Apple OAuth2 Provider for Laravel Socialite

1128.1k](/packages/seoda-socialite-apple)[truckersmp/steam-socialite

Laravel Socialite provider for Steam OpenID.

1516.7k](/packages/truckersmp-steam-socialite)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
