PHPackages                             voffice-indonesia/core-sdk - 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. voffice-indonesia/core-sdk

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

voffice-indonesia/core-sdk
==========================

SDK for using single of truth authentication service(vAuth) in other internal vOffice app with seamless integration.

v0.1.9(9mo ago)068[5 PRs](https://github.com/voffice-indonesia/core-sdk/pulls)MITPHPPHP ^8.2CI passing

Since Jul 10Pushed 1mo agoCompare

[ Source](https://github.com/voffice-indonesia/core-sdk)[ Packagist](https://packagist.org/packages/voffice-indonesia/core-sdk)[ Docs](https://github.com/voffice-indonesia/core-sdk)[ GitHub Sponsors](https://github.com/voffice-indonesia)[ RSS](/packages/voffice-indonesia-core-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (17)Versions (16)Used By (0)

Core SDK - Laravel Passport OAuth Integration
=============================================

[](#core-sdk---laravel-passport-oauth-integration)

A powerful, plug-and-play Laravel package for seamless OAuth integration with Laravel Passport servers. Built with **Clean Architecture** principles for enterprise-grade applications.

[![Latest Version on Packagist](https://camo.githubusercontent.com/3afb32f7caee5bbb6e88df16f397e91456d2bb00237501c8963adf559785125e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f766f66666963652d696e646f6e657369612f636f72652d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/voffice-indonesia/core-sdk)[![GitHub Tests Action Status](https://camo.githubusercontent.com/6106291e40c7410cd9adfe41cb08a2aba14938194c4579e1a84de496d5872f73/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f766f66666963652d696e646f6e657369612f636f72652d73646b2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/voffice-indonesia/core-sdk/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/75b986327bfa448781be8edf20fec2eedbb2cb9d4525771f9ea2ff2834e27fe0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f766f66666963652d696e646f6e657369612f636f72652d73646b2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/voffice-indonesia/core-sdk/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/578c05b095f5093842683cc8880e8170e8897879588cc3b20fde328be9fe57d5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f766f66666963652d696e646f6e657369612f636f72652d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/voffice-indonesia/core-sdk)

✨ Key Features
--------------

[](#-key-features)

- 🚀 **Plug &amp; Play**: Zero configuration, works out of the box
- 🔐 **Enterprise Security**: OAuth2 + PKCE with automatic token refresh
- 🏗️ **Clean Architecture**: SOLID principles, testable, maintainable
- 🎨 **Modern UI**: Livewire 3.0 components with Tailwind CSS
- ⚡ **Laravel Integration**: Custom guards, Filament compatible, middleware
- 🧪 **Fully Tested**: 33+ tests with comprehensive coverage

🚀 Quick Start
-------------

[](#-quick-start)

### 1. Install

[](#1-install)

```
composer require voffice-indonesia/core-sdk
```

### 2. Setup

[](#2-setup)

```
php artisan core:setup
```

### 3. Configure Environment

[](#3-configure-environment)

```
VAUTH_URL=https://your-oauth-server.com
VAUTH_CLIENT_ID=your-client-id
VAUTH_CLIENT_SECRET=your-client-secret
VAUTH_REDIRECT_URI=https://your-app.com/auth/oauth/callback
```

### 4. Protect Routes

[](#4-protect-routes)

```
Route::middleware(['vauth'])->group(function () {
    Route::get('/dashboard', [DashboardController::class, 'index']);
});
```

### 5. Use VAuth Service

[](#5-use-vauth-service)

```
use VoxDev\Core\Facades\VAuth;

// Get users from OAuth server
$users = VAuth::getUsers();

// Get locations
$locations = VAuth::getLocations();

// Check authentication
$isAuthenticated = VAuth::hasValidToken();
```

**🎉 That's it! Your app now has OAuth authentication!**

📚 Documentation
---------------

[](#-documentation)

📖 **[Complete Documentation](docs/README.md)**

### Getting Started

[](#getting-started)

- [📦 Installation Guide](docs/installation.md) - Step-by-step setup
- [⚙️ Configuration](docs/configuration.md) - Complete configuration reference
- [🚀 Basic Usage](docs/usage/basic-usage.md) - Essential features and patterns

### Usage Guides

[](#usage-guides)

- [🛡️ Middleware](docs/usage/middleware.md) - Route protection and authentication
- [📡 VAuth Service](docs/usage/vauth-service.md) - API integration and data fetching
- [🎨 Livewire Components](docs/usage/livewire-components.md) - Reactive UI components
- [🔧 Filament Integration](docs/usage/filament-integration.md) - Admin panel integration

### Architecture &amp; Advanced

[](#architecture--advanced)

- [🏗️ Clean Architecture](docs/architecture/clean-architecture.md) - Architecture principles
- [📁 Package Structure](docs/architecture/structure.md) - Code organization
- [🔌 Extending the Package](docs/architecture/extending.md) - Customization guide

### Examples &amp; Reference

[](#examples--reference)

- [💻 Code Examples](docs/examples/) - Real-world implementations
- [📋 API Reference](docs/api/) - Complete API documentation
- [🚨 Troubleshooting](docs/troubleshooting.md) - Common issues and solutions

🎯 Use Cases
-----------

[](#-use-cases)

This package is perfect for:

- **Internal company applications** that need centralized authentication
- **Microservices architecture** with shared authentication service
- **Multi-tenant applications** with OAuth-based user management
- **Enterprise applications** requiring clean, maintainable code
- **Rapid prototyping** with plug-and-play OAuth integration

🛠️ Requirements
---------------

[](#️-requirements)

- **PHP**: 8.2+
- **Laravel**: 10.x, 11.x, 12.x
- **Laravel Passport OAuth Server**: Running and accessible

🔧 Advanced Features
-------------------

[](#-advanced-features)

### Clean Architecture

[](#clean-architecture)

Built with clean architecture principles:

- Domain-driven design
- Dependency inversion
- SOLID principles
- Fully testable

### Auto-Configuration

[](#auto-configuration)

Intelligent defaults that just work:

- Auth guards auto-registered
- Middleware auto-configured
- Routes auto-loaded
- Livewire components auto-registered

### Enterprise Security

[](#enterprise-security)

Production-ready security features:

- OAuth2 with PKCE
- Automatic token refresh
- Secure cookie handling
- Session optimization

🧪 Testing
---------

[](#-testing)

```
composer test
```

The package includes comprehensive tests:

- 33+ test cases
- Feature and unit tests
- Architecture tests
- Clean code validation

🔄 Changelog
-----------

[](#-changelog)

Please see [CHANGELOG](CHANGELOG.md) for recent changes.

🤝 Contributing
--------------

[](#-contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

🔒 Security Vulnerabilities
--------------------------

[](#-security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

📄 License
---------

[](#-license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

🙏 Credits
---------

[](#-credits)

- [VOffice Indonesia](https://github.com/voffice-indonesia)
- [All Contributors](../../contributors)

---

Made with ❤️ by [VOffice Indonesia](https://github.com/voffice-indonesia)

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance77

Regular maintenance activity

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 93.3% 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 ~2 days

Total

10

Last Release

283d ago

PHP version history (2 changes)v0.1.0PHP ^8.4

v0.1.4PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/b29a271545f4f5441ed304fa5da977f5a80fd7cf6976771bc8f4a2a2ad469740?d=identicon)[zydnrbrn-voffice](/maintainers/zydnrbrn-voffice)

---

Top Contributors

[![zydnrbrn](https://avatars.githubusercontent.com/u/107527120?v=4)](https://github.com/zydnrbrn "zydnrbrn (28 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

---

Tags

laravelcore-sdkvoffice-indonesia

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/voffice-indonesia-core-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/voffice-indonesia-core-sdk/health.svg)](https://phpackages.com/packages/voffice-indonesia-core-sdk)
```

###  Alternatives

[spatie/laravel-permission

Permission handling for Laravel 12 and up

12.9k89.8M1.0k](/packages/spatie-laravel-permission)[tymon/jwt-auth

JSON Web Token Authentication for Laravel and Lumen

11.5k49.1M347](/packages/tymon-jwt-auth)[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[php-open-source-saver/jwt-auth

JSON Web Token Authentication for Laravel and Lumen

8359.8M52](/packages/php-open-source-saver-jwt-auth)[jeffgreco13/filament-breezy

A custom package for Filament with login flow, profile and teams support.

1.0k1.7M41](/packages/jeffgreco13-filament-breezy)[dutchcodingcompany/filament-socialite

Social login for Filament through Laravel Socialite

213914.9k9](/packages/dutchcodingcompany-filament-socialite)

PHPackages © 2026

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