PHPackages                             codewiser/postie - 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. [Mail & Notifications](/categories/mail)
4. /
5. codewiser/postie

ActiveLibrary[Mail & Notifications](/categories/mail)

codewiser/postie
================

Subscription management Laravel package

v1.2.5(11mo ago)01.2kMITPHPPHP ^7.4|^8.0

Since May 25Pushed 11mo ago3 watchersCompare

[ Source](https://github.com/C0deWiser/postie)[ Packagist](https://packagist.org/packages/codewiser/postie)[ RSS](/packages/codewiser-postie/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (39)Used By (0)

Postie
======

[](#postie)

Postie is a dashboard where users can manage their subscription preferences.

- [Installation](#installation)
- [Configuration](#configuration)
    - [Subscriptions](#subscription-definition)
    - [Channels](#channel-definition)
    - [Groups](#grouping-subscriptions)
    - [Preview](#previewing-notifications)
- [Sending Notifications](#sending-notifications)

Every `Notification` in application has corresponding audience. It doesn't mean, that everyone from audience will receive a notification, but it is possible. So, Postie allows user to decide what channels he or she wants to be used to deliver notification.

[![Postie](postie.png)](postie.png)

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

[](#installation)

Install Postie into your project using the Composer package manager:

```
composer require codewiser/postie

```

After installing Postie, publish its assets using the `postie:install` Artisan command:

```
php artisan postie:install

```

Before running migrations you may want to change name of the table, that keeps user subscription preferences. Then see `config/postie.php`.

```
'table' => env('POSTIE_TABLE', 'subscriptions'),
```

After you configured table name run migrations:

```
php artisan migrate

```

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

[](#configuration)

After installing Postie, its service provider will be located at `App\Proviers\PostieServiceProvider`.

First, provide information about every `Notification`, that users may manage. Every subscription requires list of available channels and possible audience (as builder).

```
use Codewiser\Postie\Subscription;
use Codewiser\Postie\PostieApplicationServiceProvider;

class PostieServiceProvider extends PostieApplicationServiceProvider
{
public function notifications(): array
    {
        return [
            Subscription::to(NewOrderNotification::class)
                ->via('mail', 'database')
                ->for(fn() => User::query()->where('role', 'sales-manager'))
        ];
}
```

Second, replace `Notification::via()` method with `\Codewiser\Postie\Notifications\Traits\Channelization` trait. `Notification` will use list of channels defined in associated `Subscription`.

```
namespace App\Notifications;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Notification;
use Codewiser\Postie\Notifications\Traits\Channelization;

class NewOrderNotification extends Notification implements ShouldQueue
{
    use Queueable, Channelization;

    public function __construct(public Order $order)
    {
        //
    }

    public function toMail($notifiable)
    {
        return (new MailMessage)
            ->subject("New order")
            ->line('User makes new order.');
    }

    public function toArray($notifiable)
    {
        return $this->order->toArray();
    }
}
```

### Subscription Definition

[](#subscription-definition)

`Subscription` is an object, that helps you describe application notification for Postie to understand.

Initially, it is enough to pass notification class name, query builder with users, who may receive such notification and channels list, supported by notification.

```
use Codewiser\Postie\Subscription;

Subscription::to(Notification::class)
    ->via('mail')
    ->for(fn() => User::query())
```

Moreover, you may define notification title and description.

```
use Codewiser\Postie\Subscription;

Subscription::to(DailyNewsNotification::class)
    ->via('mail')
    ->for(fn() => User::query())
    ->title('Daily News Notification')
    ->description('Sends most interesting news digest')
```

### Channel Definition

[](#channel-definition)

When you set up `Subscription`, you may pass channel as a simple string. But there are a way to define more complex channel representation.

You may use `\Codewiser\Postie\Channel` object to describe channel with custom title, icon etc.:

```
use Codewiser\Postie\Channel;
use Codewiser\Postie\Subscription;

$mail = Channel::via('mail')
    ->icon('envelope')
    ->title('via email')
    ->subtitle('Sends emails');

Subscription::to(DailyNewsNotification::class)
    ->via($mail);
```

You may define default state of channel. If channel is active, then all users will receive notifications through this channel until they unsubscribe. Vice versa, if channel is passive, all users will not receive notifications via this channel until they subscribe to it.

Default channel state is active.

```
use Codewiser\Postie\Channel;

$mail = Channel::via('mail')->passive();
```

If you want to disable user ability to manage channel preferences, you may hide channel form user interface, or just force channel state.

```
use Codewiser\Postie\Channel;

$mail = Channel::via('database')->hidden();
```

```
use Codewiser\Postie\Channel;

$mail = Channel::via('mail')->active()->forced();
```

### Grouping Subscriptions

[](#grouping-subscriptions)

You may group subscriptions to create side menu for dashboard. Subscriptions inherit channels and audience form a group, if defined.

```
use Codewiser\Postie\Group;
use Codewiser\Postie\Subscription;

Group::make('My group')
    ->icon('broadcast')
    ->via('mail', 'database')
    ->for(fn() => User::query())
    ->add(Subscription::to(DailyNewsNotification::class)
    ->add(Subscription::to(NewOrderNotification::class)
```

### Previewing Notifications

[](#previewing-notifications)

You may define notification preview. So user can see how notification will be looks like.

Notification preview may be composed with model factories...

```
use Codewiser\Postie\Subscription;

Subscription::to(DailyNewsNotification::class)
    ->via('email')
    ->for(fn() => User::query())
    ->preview(function(string $channel, $notifiable) {

        $news = NewsItem::factory()->count(3)->make();

        $notification = new DailyNewsNotification($news);

        return match ($channel) {
            'mail' => $notification->toMail($notifiable),
            'telegram' => $notification->toTelegram($notifiable),
            'database', 'broadcast' => $notification->toArray($notifiable),
        };
    });
```

Sending Notifications
---------------------

[](#sending-notifications)

Using Postie, you may simply send notification without defining notifiables, as Postie already knows subscribers.

```
use Codewiser\Postie\Contracts\Postie;

class OrderController extends Controller
{
    public function store(OrderStoreRequest $request, Postie $postie)
    {
        $order = Order::create($request->validated());

        $postie->send(new NewOrderNotification($order));
    }
}
```

If you need to limit notifiables, you may use a callback:

```
use Codewiser\Postie\Contracts\Postie;

class OrderController extends Controller
{
    public function store(OrderStoreRequest $request, Postie $postie)
    {
        $order = Order::create($request->validated());

        $postie->send(new NewOrderNotification($order), function($builder) use ($order) {
            if ($order->amount > 10) {
                return $builder->where('level', 'vip');
            } else {
                return $builder->whereNull('level');
            }
        });
    }
}
```

You still may send notifications using `Facade` or `notify()` method. As `Notification` uses `Channelization` trait, it will respect user preferences.

```
$user->notify(new NewOrderNotification($order));
```

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance51

Moderate activity, may be stable

Popularity17

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

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

Recently: every ~93 days

Total

38

Last Release

347d ago

Major Versions

v0.1.12 → v1.0.02022-11-26

### Community

Maintainers

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

---

Top Contributors

[![Cellard](https://avatars.githubusercontent.com/u/1220316?v=4)](https://github.com/Cellard "Cellard (46 commits)")[![abduraim](https://avatars.githubusercontent.com/u/17427874?v=4)](https://github.com/abduraim "abduraim (6 commits)")

---

Tags

laravelnotificationsnotifification-previewsubscription-managerlaravelnotificationssubscription

### Embed Badge

![Health badge](/badges/codewiser-postie/health.svg)

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

###  Alternatives

[liran-co/laravel-notification-subscriptions

Notification subscription management.

128239.2k1](/packages/liran-co-laravel-notification-subscriptions)[coreproc/nova-notification-feed

A Laravel Nova package that adds a notification feed in your Nova app.

10149.1k](/packages/coreproc-nova-notification-feed)[matviib/notifier

NO LIBRARIES socket per page bridge for your Laravel application.

621.2k](/packages/matviib-notifier)[sarfraznawaz2005/laravel-sse

Laravel package to provide Server Sent Events functionality for your app.

474.6k](/packages/sarfraznawaz2005-laravel-sse)

PHPackages © 2026

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