PHPackages                             developers-hub-my/g8key-client - 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. developers-hub-my/g8key-client

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

developers-hub-my/g8key-client
==============================

G8Key license client for verification, activation, and heartbeat in G8Suite products

v0.2.0(1mo ago)00MITPHPPHP ^8.4CI passing

Since Apr 29Pushed 1mo agoCompare

[ Source](https://github.com/developers-hub-my/g8key-client)[ Packagist](https://packagist.org/packages/developers-hub-my/g8key-client)[ Docs](https://github.com/developers-hub-my/g8key-client)[ GitHub Sponsors]()[ RSS](/packages/developers-hub-my-g8key-client/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (2)Dependencies (12)Versions (4)Used By (0)

g8key-client
============

[](#g8key-client)

[![Latest Version](https://camo.githubusercontent.com/b05b616bfeb627117587929e6412d7c96b5ad5f0fe4f6cdae8b62531c9288aa2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f646576656c6f706572732d6875622d6d792f67386b65792d636c69656e743f7374796c653d666c61742d737175617265)](https://github.com/developers-hub-my/g8key-client/releases)[![Packagist Version](https://camo.githubusercontent.com/6e0862398c5c3f75076b39a637e2469165c459ec9342783a094fd8691d991db9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f646576656c6f706572732d6875622d6d792f67386b65792d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/developers-hub-my/g8key-client)[![License](https://camo.githubusercontent.com/2b3328bff7fd9e204693ac54d581bcf6e55691d7ac4d5bca478fe0bfbf323159/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f646576656c6f706572732d6875622d6d792f67386b65792d636c69656e743f7374796c653d666c61742d737175617265)](LICENSE.md)[![Tests](https://camo.githubusercontent.com/544b43455349c54b265b2873f55bcbf8043fa94b51cdde6994e6e41f399c9bd5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f646576656c6f706572732d6875622d6d792f67386b65792d636c69656e742f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/developers-hub-my/g8key-client/actions?query=workflow%3Arun-tests+branch%3Amain)[![Code Style](https://camo.githubusercontent.com/ff1207662f4786aa38c6d4f7699872d686aa863e7692be758b70b53322e06d94/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f646576656c6f706572732d6875622d6d792f67386b65792d636c69656e742f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/developers-hub-my/g8key-client/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/9abec5840b7a9e47116f8dacc5128e7b341293a6bc63fe3e6f11aac81ffd31ba/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f646576656c6f706572732d6875622d6d792f67386b65792d636c69656e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/developers-hub-my/g8key-client)

Shared Laravel client for [G8Key](https://lic.g8suite.com) licensing. Every G8Suite product (G8Stack, G8ID, G8Connect, …) installs this package to verify offline EdDSA tokens, run activation and heartbeat against the G8Key server, and gate features through a `License` facade and route middleware.

Features
--------

[](#features)

- Offline EdDSA token verification mirroring the server-side verifier
- `php artisan license:activate`, `license:heartbeat`, `license:deactivate`, `license:status`
- `License` facade with `has()`, `tier()`, `seats()`, `expiresAt()`, `isValid()`
- Route middleware (`license`, `license.feature:{name}`) and Blade `@licenseFeature` directive
- Pluggable license store (file or database)
- Multi-`kid` public-key map for zero-downtime key rotation

Installation
------------

[](#installation)

```
composer require developers-hub-my/g8key-client
php artisan vendor:publish --tag="g8key-client-config"
```

If using the database store:

```
php artisan vendor:publish --tag="g8key-client-migrations"
php artisan migrate
```

Quick Start
-----------

[](#quick-start)

Configure `.env`:

```
G8KEY_AUDIENCE=g8stack
G8KEY_API_BASE=https://lic.g8suite.com
G8STACK_LICENSE_PUBLIC_KEY_G8STACK_2026_04=
```

Activate, schedule, and gate:

```
php artisan license:activate G8ST-K7HM-3PXR-9F2B-WQ8N
```

```
// routes/console.php
Schedule::command('license:heartbeat')->daily()->withoutOverlapping();
```

```
use G8Key\Client\Facades\License;

if (License::has('sso')) {
    // SSO is on this license tier
}
```

Documentation
-------------

[](#documentation)

Full documentation lives in [`docs/`](docs/README.md):

- [Getting Started](docs/01-getting-started/README.md) — install, quick start, configuration
- [Architecture](docs/02-architecture/README.md) — package layout, token format, data flow
- [Integration](docs/03-integration/README.md) — activation, heartbeat, entitlements, deactivation
- [Configuration](docs/04-configuration/README.md) — env vars, public keys, stores
- [Operations](docs/05-operations/README.md) — key rotation, offline grace, troubleshooting
- [Development](docs/06-development/README.md) — implementation plan, testing, contributing
- [Decisions](docs/07-decisions/README.md) — architecture decision records

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

See [CHANGELOG.md](CHANGELOG.md).

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

[](#contributing)

See [docs/06-development/03-contributing.md](docs/06-development/03-contributing.md).

Security
--------

[](#security)

If you discover a security issue, email  rather than opening a public issue.

Credits
-------

[](#credits)

- [Nasrul Hazim Bin Mohamad](https://github.com/nasrulhazim)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). See [LICENSE.md](LICENSE.md).

###  Health Score

37

—

LowBetter than 81% of packages

Maintenance92

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

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 ~0 days

Total

2

Last Release

39d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b57069d0f4b634f65eccc6e5d5848990e25968d45ec2cf46d626c6a4658f944b?d=identicon)[nasrulhazim.m](/maintainers/nasrulhazim.m)

---

Top Contributors

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

---

Tags

laravellicenselicensingg8keyg8suitedevelopers-hub-my

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/developers-hub-my-g8key-client/health.svg)

```
[![Health](https://phpackages.com/badges/developers-hub-my-g8key-client/health.svg)](https://phpackages.com/packages/developers-hub-my-g8key-client)
```

###  Alternatives

[spatie/laravel-permission

Permission handling for Laravel 12 and up

12.9k98.0M1.3k](/packages/spatie-laravel-permission)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.3M41](/packages/spatie-laravel-pdf)[spatie/laravel-passkeys

Use passkeys in your Laravel app

463755.5k32](/packages/spatie-laravel-passkeys)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)[jeffgreco13/filament-breezy

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

1.0k1.9M52](/packages/jeffgreco13-filament-breezy)[spatie/laravel-health

Monitor the health of a Laravel application

88011.3M149](/packages/spatie-laravel-health)

PHPackages © 2026

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