PHPackages                             blaspsoft/socialiteplus - 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. blaspsoft/socialiteplus

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

blaspsoft/socialiteplus
=======================

SocialitePlus is a Laravel package that simplifies social authentication by extending Laravel Socialite. It provides predefined Google, Facebook, GitHub, and LinkedIn login options for seamless integration into Laravel 12 Vue and React Starter Kits

v1.0.2(1y ago)612.8k7[2 issues](https://github.com/Blaspsoft/socialiteplus/issues)[1 PRs](https://github.com/Blaspsoft/socialiteplus/pulls)MITPHPPHP ^8.0|^8.1|^8.2

Since Mar 12Pushed 1y ago1 watchersCompare

[ Source](https://github.com/Blaspsoft/socialiteplus)[ Packagist](https://packagist.org/packages/blaspsoft/socialiteplus)[ Docs](https://github.com/blaspsoft/socialiteplus)[ RSS](/packages/blaspsoft-socialiteplus/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)Dependencies (4)Versions (4)Used By (0)

 [![Blasp Icon](./assets/icon.png)](./assets/icon.png)

 [![Total Downloads](https://camo.githubusercontent.com/1e57a287d818b04448ad4ce84470b25cb2154cf96a9b0e893a1733cbe16d888c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f626c617370736f66742f736f6369616c697465706c7573)](https://packagist.org/packages/blaspsoft/socialiteplus) [![Latest Version](https://camo.githubusercontent.com/5fbd2861f9ff70d548a78b4e2384952611250c6d866f50d23a45e4cdc4e81884/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f626c617370736f66742f736f6369616c697465706c7573)](https://packagist.org/packages/blaspsoft/socialiteplus) [![License](https://camo.githubusercontent.com/b22cf39d8a96da8053cf27fb72abee19bb8f09a29872a1a8d0046ffd56144b77/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f626c617370736f66742f736f6369616c697465706c7573)](https://packagist.org/packages/blaspsoft/socialiteplus)

Socialite Plus - Laravel Socialite made even easier
===================================================

[](#socialite-plus---laravel-socialite-made-even-easier)

**Socialite Plus** is a Laravel 12 React &amp; Vue Starterkit package that streamlines social login for Google, Facebook, GitHub and LinkedIn.

---

🎥 SocialitePlus Video Tutorial
------------------------------

[](#-socialiteplus-video-tutorial)

[![Watch the Tutorial](https://camo.githubusercontent.com/86455781da9381f69c489e415715dc679cd22cb919e6dce94f008bdd52a5b070/68747470733a2f2f696d672e796f75747562652e636f6d2f76692f58393650546c50556c61512f6d617872657364656661756c742e6a7067)](https://www.youtube.com/watch?v=X96PTlPUlaQ)

**▶️ Click the image above to watch the tutorial on YouTube!**

✨ Features
----------

[](#-features)

- ✅ Predefined Social Login Pages – Ready-to-use authentication pages built with React &amp; Vue.
- 🎯 Seamless OAuth Integration – Supports Google, Facebook, GitHub, and LinkedIn logins.
- ⚙️ Configurable Providers – Enable or disable social logins via a simple config file.
- 🎨 Customizable Button Text &amp; Styles – Personalize login button labels and appearance.
- ⚡ Effortless Setup – Quick configuration using Laravel Socialite.
- 🔄 Full Social Auth Flow – Handles login, registration, and token management.
- 🔐 Secure &amp; Scalable – Built with best practices for authentication and security.
- 🌍 Multi-Framework Support – Works with both React and Vue frontends.
- 📦 Out-of-the-Box Functionality – Reduce development time with pre-built components

---

🛠 Requirements
--------------

[](#-requirements)

Before installing **Keysmith React**, ensure your environment meets the following requirements:

- PHP **8.0+**
- Laravel **12.x**
- React **19.x** or Vue **3.x**
- Laravel Socialite **5.0**

---

🚀 Installation Guide
--------------------

[](#-installation-guide)

Follow these simple steps to install and configure Socialite Plus in your Laravel 12 Vue or React starterkit project.

---

1️⃣ Install the Package

Run the following command in your terminal to install the package via Composer:

```
composer require blaspsoft/socialiteplus
```

---

2️⃣ Choose Your Frontend Framework

After installation, you need to specify whether you want to use Vue or React. Run one of the following commands:

#### **Vue**

[](#vue)

```
php artisan socialiteplus:install vue
```

#### **React**

[](#react)

```
php artisan socialiteplus:install react
```

This command will generate pre-built authentication components for your chosen frontend.

---

3️⃣ Publish the Configuration File

Run the following command to publish the `config/socialiteplus.php` file:

```
php artisan vendor:publish --tag=socialiteplus-config
```

This will allow you to customize social login settings. For changes to take effect you may need to clear the config cache:

```
php artisan config:cache
```

---

4️⃣ Add the Middleware to Routes

```
use App\Http\Middleware\HandleSocialitePlusProviders;

Route::get('register', [RegisteredUserController::class, 'create'])
    ->middleware(HandleSocialitePlusProviders::class)
    ->name('register');

Route::get('login', [AuthenticatedSessionController::class, 'create'])
    ->middleware(HandleSocialitePlusProviders::class)
    ->name('login');
```

5️⃣ Create OAuth Apps in Social Providers

To enable authentication, you need to register your application with each provider and obtain Client ID and Secret and set the redirect URI:

```
https://your-app.com/auth/social/{provider}/callback

```

---

6️⃣ Set Environment Variables

Update your .env file with the credentials obtained from each provider:

```
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
GOOGLE_REDIRECT=https://yourapp.com/auth/social/google/callback

FACEBOOK_CLIENT_ID=your-facebook-client-id
FACEBOOK_CLIENT_SECRET=your-facebook-client-secret
FACEBOOK_REDIRECT=https://yourapp.com/auth/social/facebook/callback

GITHUB_CLIENT_ID=your-github-client-id
GITHUB_CLIENT_SECRET=your-github-client-secret
GITHUB_REDIRECT=https://yourapp.com/auth/social/github/callback

LINKEDIN_CLIENT_ID=your-linkedin-client-id
LINKEDIN_CLIENT_SECRET=your-linkedin-client-secret
LINKEDIN_REDIRECT=https://yourapp.com/auth/social/linkedin/callback
```

---

7️⃣ Configure Socialite Plus

Modify the config/socialiteplus.php file to customize settings:

```
return [
    'button_text' => '{provider}',

    'providers' => [
        'google' => [
            'active' => true,
            'branded' => false,
            'name' => 'Google',
            'icon' => 'GoogleIcon',
            'client_id' => env('GOOGLE_CLIENT_ID'),
            'client_secret' => env('GOOGLE_CLIENT_SECRET'),
            'redirect' => env('GOOGLE_REDIRECT'),
        ],
        'facebook' => [
            'active' => true,
            'branded' => false,
            'name' => 'Facebook',
            'icon' => 'FacebookIcon',
            'client_id' => env('FACEBOOK_CLIENT_ID'),
            'client_secret' => env('FACEBOOK_CLIENT_SECRET'),
            'redirect' => env('FACEBOOK_REDIRECT'),
        ],
        'github' => [
            'active' => true,
            'branded' => false,
            'name' => 'GitHub',
            'icon' => 'GithubIcon',
            'client_id' => env('GITHUB_CLIENT_ID'),
            'client_secret' => env('GITHUB_CLIENT_SECRET'),
            'redirect' => env('GITHUB_REDIRECT'),
        ],
        'linkedin' => [
            'active' => true,
            'branded' => false,
            'name' => 'LinkedIn',
            'icon' => 'LinkedInIcon',
            'client_id' => env('LINKEDIN_CLIENT_ID'),
            'client_secret' => env('LINKEDIN_CLIENT_SECRET'),
            'redirect' => env('LINKEDIN_REDIRECT'),
        ],
    ],
];
```

---

8️⃣ Update the register and login pages

You need to update your controllers to use these pages and pass the required props.

### React Pages

[](#react-pages)

- `resources/js/pages/auth/register-social.tsx`
- `resources/js/pages/auth/login-social.tsx`

### Vue Pages

[](#vue-pages)

- `resources/js/pages/auth/RegisterSocial.vue`
- `resources/js/pages/auth/LoginSocial.vue`

Modify AuthenticatedSessionController.php for Login Ensure the login controller passes providersConfig as a prop:

```
    public function create(Request $request): Response
    {
        // React
        return Inertia::render('auth/login-social', [
            'canResetPassword' => Route::has('password.request'),
            'status' => $request->session()->get('status'),
            'providersConfig' => $request->attributes->get('providersConfig'),
        ]);

        // Vue
        return Inertia::render('auth/LoginSocial', [
            'canResetPassword' => Route::has('password.request'),
            'status' => $request->session()->get('status'),
            'providersConfig' => $request->attributes->get('providersConfig'),
        ]);
    }
```

Modify RegisteredUserController.php for Register Ensure the login controller passes providersConfig as a prop:

```
    public function create(Request $request): Response
    {
        // React
        return Inertia::render('auth/register-social', [
            'providersConfig' => $request->attributes->get('providersConfig'),
        ]);

        // Vue
        return Inertia::render('auth/RegisterSocial', [
            'providersConfig' => $request->attributes->get('providersConfig'),
        ]);
    }
```

---

🧪 Testing
---------

[](#-testing)

The package includes tests located in the `tests/Feature/SocialitePlus` directory. These tests ensure that the core functionalities of the package are working as expected.

### Test Files

[](#test-files)

- **`HandleSocialitePlusProvidersTest.php`**: Tests the middleware responsible for filtering active social providers.
- **`SocialitePlusControllerTest.php`**: Tests the controller handling social authentication redirects and callbacks.

### Running Tests

[](#running-tests)

To run the tests, use the following command:

```
php artisan test
```

This command will execute all the tests and provide feedback on their success or failure.

---

🔒 Security
----------

[](#-security)

If you discover any **security-related** issues, please email **** instead of using the issue tracker.

---

📜 Credits
---------

[](#-credits)

- [Michael Deeming](https://github.com/deemonic)

---

📄 License
---------

[](#-license)

This package is licensed under **MIT**. See [LICENSE.md](LICENSE.md) for details.

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance46

Moderate activity, may be stable

Popularity35

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.8% 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 ~11 days

Total

3

Last Release

410d ago

### Community

Maintainers

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

---

Top Contributors

[![deemonic](https://avatars.githubusercontent.com/u/25927364?v=4)](https://github.com/deemonic "deemonic (15 commits)")[![mrunkel](https://avatars.githubusercontent.com/u/3205232?v=4)](https://github.com/mrunkel "mrunkel (1 commits)")

---

Tags

facebookgithubgooglelaravellaravel12linkedinoauthphpreactsocial-loginsocialitesocialite-loginsocialite-providersvueblaspsoftsocialiteplus

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/blaspsoft-socialiteplus/health.svg)

```
[![Health](https://phpackages.com/badges/blaspsoft-socialiteplus/health.svg)](https://phpackages.com/packages/blaspsoft-socialiteplus)
```

###  Alternatives

[socialiteproviders/manager

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

42542.0M544](/packages/socialiteproviders-manager)[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)[truckersmp/steam-socialite

Laravel Socialite provider for Steam OpenID.

1516.7k](/packages/truckersmp-steam-socialite)[pschocke/laravel-telegram-login-widget

Easily integrate Telegrams login widget into your Laravel application to send Telegram messages

1610.4k](/packages/pschocke-laravel-telegram-login-widget)

PHPackages © 2026

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