PHPackages                             michal78/laravel-sms-catcher - 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. [Utility & Helpers](/categories/utility)
4. /
5. michal78/laravel-sms-catcher

ActiveLibrary[Utility & Helpers](/categories/utility)

michal78/laravel-sms-catcher
============================

A development-only inbox for inspecting Laravel SMS notifications.

v1.1.2(5mo ago)0586↑133.3%MITBladePHP ^8.1

Since Oct 28Pushed 6d agoCompare

[ Source](https://github.com/michal78/laravel-sms-catcher)[ Packagist](https://packagist.org/packages/michal78/laravel-sms-catcher)[ RSS](/packages/michal78-laravel-sms-catcher/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (2)Versions (32)Used By (0)

[![Latest Stable Version](https://camo.githubusercontent.com/7f1d2b7c777552716342ffcc2a7bea3df13cf9da460d64e22e845952994d3690/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d696368616c37382f6c61726176656c2d736d732d636174636865722e737667)](https://packagist.org/packages/michal78/laravel-sms-catcher)[![Total Downloads](https://camo.githubusercontent.com/f85be3c8d94c42808a435a7e9e4385fd0c05df04fe022fa74d3082e69f6baa50/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d696368616c37382f6c61726176656c2d736d732d636174636865722e737667)](https://packagist.org/packages/michal78/laravel-sms-catcher)[![License](https://camo.githubusercontent.com/370536ba880f6318d1c736854a69372ff98bfb4cad1f756f4589fd508de7d5c5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d696368616c37382f6c61726176656c2d736d732d636174636865722e737667)](https://packagist.org/packages/michal78/laravel-sms-catcher)

Laravel SMS Catcher
===================

[](#laravel-sms-catcher)

A development-only Laravel package that captures SMS notifications and displays them in a beautiful, phone-inspired inbox – think Mailpit, but for your `sms` notification channel.

Screenshots
-----------

[](#screenshots)

### SMS Inbox Dashboard

[](#sms-inbox-dashboard)

Click to view full-size images:

[ ![SMS Catcher inbox showing list of captured messages](https://private-user-images.githubusercontent.com/239061/507529745-9ef222e5-6a16-4fbb-a032-2558cb9edffa.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5NzUwMjAsIm5iZiI6MTc4Mjk3NDcyMCwicGF0aCI6Ii8yMzkwNjEvNTA3NTI5NzQ1LTllZjIyMmU1LTZhMTYtNGZiYi1hMDMyLTI1NThjYjllZGZmYS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNzAyJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDcwMlQwNjQ1MjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1mYjM4OTM4YWVhOWZiYmFhNGIxMzUxMTY2NjY5NjVhNmUyY2MzZTk1NDg2YTUyOGEyZDU0NWJmYmI1ZTU4YTliJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.Smlv2eKC9nnQPMVOLRjKhqn_NTHP9AvAC-thISp7nzI)](https://github.com/user-attachments/assets/9ef222e5-6a16-4fbb-a032-2558cb9edffa)*The main inbox view displays all captured SMS messages with sender, recipient, and timestamp information.*

### Message Detail View

[](#message-detail-view)

[ ![SMS message detail view with phone-style preview](https://private-user-images.githubusercontent.com/239061/507530035-be6b171d-9fcb-467c-9093-1f67faac35cf.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI5NzUwMjAsIm5iZiI6MTc4Mjk3NDcyMCwicGF0aCI6Ii8yMzkwNjEvNTA3NTMwMDM1LWJlNmIxNzFkLTlmY2ItNDY3Yy05MDkzLTFmNjdmYWFjMzVjZi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNzAyJTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDcwMlQwNjQ1MjBaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1lMDA5MjEzMTNhNDVhM2M5OTg0NDJlNzZiMDM4ZGMwNzY2Zjc1ZGQ2YjY0YWIzYmI0ODY5ZmNkNzU5Nzc3OWNjJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.3uAb1myjvsLtyEx4bz-eIQTRPLRxyLLf2OpZWi-5Xzo)](https://github.com/user-attachments/assets/be6b171d-9fcb-467c-9093-1f67faac35cf)*Click any message to see the full details in a beautiful phone-style preview, making it easy to verify how your SMS will appear to recipients.*

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

[](#installation)

Require the package in your application as a dev dependency. Until a tagged release is published you will need to target the `dev-main` branch explicitly:

```
composer require --dev michal78/laravel-sms-catcher
```

The package is auto-discovered by Laravel, but you can manually register the service provider if you have discovery disabled:

```
// config/app.php
'providers' => [
    // ...
    SmsCatcher\SmsCatcherServiceProvider::class,
];
```

Configuration
-------------

[](#configuration)

By default the dashboard is only enabled when your application is running in the `local` environment or when `APP_DEBUG=true`. You can override this behaviour via the `SMS_CATCHER_ENABLED` environment variable.

Publish the configuration file if you would like to customise the dashboard path or storage location:

```
php artisan vendor:publish --tag=sms-catcher-config
```

This will create `config/sms-catcher.php` with the following options:

- `enabled`: Toggle the catcher on/off.
- `route.prefix`: URL prefix for the dashboard (defaults to `/sms-catcher`).
- `route.middleware`: Middleware stack wrapping the dashboard routes.
- `storage_path`: File that stores captured messages.

Usage
-----

[](#usage)

Trigger any Laravel notification that uses the `sms` channel and the payload will be recorded automatically. Visit the dashboard (default at `http://your-app.test/sms-catcher`) to see the inbox:

- Inbox view summarises each message.
- Click a message to view details and a phone-style preview.
- Clear individual messages or wipe the entire inbox.

Messages are stored as JSON within your application's storage folder (`storage/logs/sms-catcher.json`). The file is safe to delete; it will be recreated as new messages arrive. Since the `storage/logs` directory is typically excluded from version control in Laravel applications, the captured messages will not be committed to your repository.

> **Note**: The catcher inspects notifications by invoking their `toSms` method. Ensure your notifications implement this method and return either a string, array, or object containing the text body.

Security
--------

[](#security)

This package is intended for local development only. Do not enable it in production environments.

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance87

Actively maintained with recent releases

Popularity18

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

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

Recently: every ~20 days

Total

13

Last Release

166d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/27c8fa2ab59c3e8cbaf0c8d4638b6f2b16cf6104ad54e568824eeab753bd0d59?d=identicon)[michal78](/maintainers/michal78)

---

Top Contributors

[![michal78](https://avatars.githubusercontent.com/u/239061?v=4)](https://github.com/michal78 "michal78 (37 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (24 commits)")

### Embed Badge

![Health badge](/badges/michal78-laravel-sms-catcher/health.svg)

```
[![Health](https://phpackages.com/badges/michal78-laravel-sms-catcher/health.svg)](https://phpackages.com/packages/michal78-laravel-sms-catcher)
```

###  Alternatives

[binsoul/net-mqtt

MQTT protocol implementation

29908.8k7](/packages/binsoul-net-mqtt)[sssurii/laravel-ics

Laravel package to create iCalendar / ICS files. Send new event invitations via Email and can cancel or update already sent invitation.

2162.8k](/packages/sssurii-laravel-ics)[humanmade/altis-reusable-blocks

Adds functionality to reusable blocks to enhance their usage.

11197.5k9](/packages/humanmade-altis-reusable-blocks)

PHPackages © 2026

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