PHPackages                             andreaalhena/prelude-sdk-laravel - 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. andreaalhena/prelude-sdk-laravel

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

andreaalhena/prelude-sdk-laravel
================================

Laravel integration for the official Prelude PHP SDK: phone verification, lookup, transactional messages, notifications and anti-fraud signals.

v1.0.0(1mo ago)01MITPHPPHP ^8.2

Since Jun 14Pushed 1mo agoCompare

[ Source](https://github.com/AndreaAlhena/prelude-sdk-laravel)[ Packagist](https://packagist.org/packages/andreaalhena/prelude-sdk-laravel)[ Docs](https://github.com/AndreaAlhena/prelude-sdk-laravel)[ RSS](/packages/andreaalhena-prelude-sdk-laravel/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (1)Dependencies (7)Versions (3)Used By (0)

Prelude SDK for Laravel
=======================

[](#prelude-sdk-for-laravel)

[![Tests](https://github.com/AndreaAlhena/prelude-sdk-laravel/actions/workflows/tests.yml/badge.svg)](https://github.com/AndreaAlhena/prelude-sdk-laravel/actions/workflows/tests.yml)[![Latest Version on Packagist](https://camo.githubusercontent.com/7a395e805e85718f03f2ae22864ad4764818706ba7a590d08b1c01185b25e29f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e64726561616c68656e612f7072656c7564652d73646b2d6c61726176656c2e737667)](https://packagist.org/packages/andreaalhena/prelude-sdk-laravel)[![License](https://camo.githubusercontent.com/d1ebe09d19aaaf67f6a262d42d972eae117c34a2c119b3c38fd77cf4a73a7e04/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f616e64726561616c68656e612f7072656c7564652d73646b2d6c61726176656c2e737667)](LICENSE.md)

A Laravel integration for the official [Prelude PHP SDK](https://github.com/prelude-so/php-sdk). Phone number verification (OTP), lookups, transactional messages, notifications and anti-fraud signals — wired into the Laravel container, configured the Laravel way and testable without ever hitting the API.

📖 **Documentation:** [prelude-sdk-laravel.andreatantimonaco.me](https://prelude-sdk-laravel.andreatantimonaco.me)

[Prelude documentation](https://docs.prelude.so/introduction/welcome-to-prelude)

Requirements
------------

[](#requirements)

- PHP 8.2+
- Laravel 12 or 13

Compatibility
-------------

[](#compatibility)

This package follows its own [semantic versioning](https://semver.org) timeline, independent of the upstream SDK. The table below maps each package release to the versions it is tested against.

PackagePrelude PHP SDKLaravelPHP`^1.0``^0.4.0`12 – 138.2+The Prelude PHP SDK is currently pre-1.0, so its minor releases may introduce breaking changes. The package therefore tracks a single SDK minor (`^0.4.0`, i.e. `>=0.4.0 raw->create(/* ... */);
```

### Escape hatch

[](#escape-hatch)

The underlying SDK client is bound as a singleton and always within reach:

```
$client = Prelude::client(); // \Prelude\Client
```

Testing your application
------------------------

[](#testing-your-application)

`Prelude::fake()` swaps the SDK client with one backed by a fake transporter, so your tests replay queued responses instead of calling the API:

```
use AndreaAlhena\PreludeSdkLaravel\Facades\Prelude;

it('verifies the phone number', function () {
    $fake = Prelude::fake();
    $fake->queueJson([
        'id' => 'vrf_01jc0t6fwwfgfsq1md24mhyztj',
        'method' => 'message',
        'status' => 'success',
    ]);

    // ... code under test calling Prelude::verification()->create(...) ...

    $fake->assertSentCount(1);
    $fake->assertSent(fn ($request) => str_ends_with($request->getUri()->getPath(), '/v2/verification'));
});
```

The fake transporter also offers `queue()` for full PSR-7 responses, `recorded()`to inspect every sent request, and `assertNothingSent()`.

Testing the package
-------------------

[](#testing-the-package)

```
composer test
```

License
-------

[](#license)

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

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

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

Unknown

Total

1

Last Release

46d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6db9affa09a392b44d0d5a7c1839395c4caad414b28310ee638fdd7f4dffdb2e?d=identicon)[AndreaAlhena](/maintainers/AndreaAlhena)

---

Tags

laravelsdkotp2fasmstwo-factorverificationPrelude

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/andreaalhena-prelude-sdk-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/andreaalhena-prelude-sdk-laravel/health.svg)](https://phpackages.com/packages/andreaalhena-prelude-sdk-laravel)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.2k](/packages/craftcms-cms)[moonshine/moonshine

Laravel administration panel

1.3k253.1k86](/packages/moonshine-moonshine)

PHPackages © 2026

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