PHPackages                             usamamuneerchaudhary/filament-notifier - 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. usamamuneerchaudhary/filament-notifier

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

usamamuneerchaudhary/filament-notifier
======================================

A powerful notification system for FilamentPHP that handles multi-channel notifications with template management, scheduling, and real-time delivery. Built for developers who need enterprise-grade notifications without the complexity.

1.4(2mo ago)321.1k↓44.3%7MITPHPPHP ^8.2

Since Dec 19Pushed 2mo agoCompare

[ Source](https://github.com/usamamuneerchaudhary/filament-notifier)[ Packagist](https://packagist.org/packages/usamamuneerchaudhary/filament-notifier)[ GitHub Sponsors](https://github.com/usamamuneerchaudhary)[ RSS](/packages/usamamuneerchaudhary-filament-notifier/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (5)Dependencies (10)Versions (5)Used By (0)

Filament Notifier
=================

[](#filament-notifier)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c90547d876cbebf3a315c71ccf46398c0616ff4119a2c061a48aec291f1ebf46/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7573616d616d756e6565726368617564686172792f66696c616d656e742d6e6f7469666965723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/usamamuneerchaudhary/filament-notifier)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/8d9dbf7a7bdd27deed9bc82ec09ce6a205fe76cf3917b491ec3f0792348acbe9/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7573616d616d756e6565726368617564686172792f66696c616d656e742d6e6f7469666965722f6261646765732f7175616c6974792d73636f72652e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/usamamuneerchaudhary/filament-notifier/?branch=main)[![CodeFactor](https://camo.githubusercontent.com/23ca87e69048f2d39f1f9dc7bf8bc6172c15227326103349f6cbdfe8631c6fd8/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f7573616d616d756e6565726368617564686172792f66696c616d656e742d6e6f7469666965722f6261646765)](https://www.codefactor.io/repository/github/usamamuneerchaudhary/filament-notifier)[![Build Status](https://camo.githubusercontent.com/5ab810d7fc7f2abb2c5979ffb1c7e8e415344d6c7671bc945c2cf20d53a9ac89/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7573616d616d756e6565726368617564686172792f66696c616d656e742d6e6f7469666965722f6261646765732f6275696c642e706e673f623d6d61696e)](https://scrutinizer-ci.com/g/usamamuneerchaudhary/filament-notifier/build-status/main)[![Code Intelligence Status](https://camo.githubusercontent.com/11d6d4b7f1f2f4ee16f7ac588942e35cd750e9769b42d55b7dbb74ee49d5571e/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f7573616d616d756e6565726368617564686172792f66696c616d656e742d6e6f7469666965722f6261646765732f636f64652d696e74656c6c6967656e63652e7376673f623d6d61696e)](https://scrutinizer-ci.com/code-intelligence)[![Total Downloads](https://camo.githubusercontent.com/c259a700fb74e31a40bcdde15296a1df001bef4ecee77296f82bf636f2bb17d1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7573616d616d756e6565726368617564686172792f66696c616d656e742d6e6f7469666965723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/usamamuneerchaudhary/filament-notifier)[![Licence](https://camo.githubusercontent.com/25443881e7c4dc4579a54208f745b19a3e359c064fa95b2179e0896078b5e1be/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7573616d616d756e6565726368617564686172792f66696c616d656e742d6e6f7469666965723f7374796c653d666c61742d737175617265)](https://github.com/usamamuneerchaudhary/filament-notifier/blob/HEAD/LICENSE.md)

A powerful notification system for FilamentPHP that handles multi-channel notifications with template management, scheduling, and real-time delivery. Built for developers who need enterprise-grade notifications without the complexity.

 [![Filament Notifier Banner](public/images/filament notifier.gif)]()

Features
--------

[](#features)

- 🚀 **Multi-Channel Support**: Email, SMS, Slack, Discord, Push, and more
- 📝 **Template Management**: Create and manage notification templates with variable support
- ⏰ **Scheduled Notifications**: Send notifications at specific times
- 🎯 **Event-Driven**: Trigger notifications based on application events
- 👥 **User Preferences**: Allow users to control their notification preferences via REST API
- 📊 **Analytics Dashboard**: Comprehensive dashboard with engagement metrics, charts, and insights
- 📈 **Email Tracking**: Track email opens and link clicks with analytics
- ⚡ **Rate Limiting**: Built-in rate limiting to prevent abuse (per minute, hour, day)
- 🔧 **Easy Configuration**: Simple setup with comprehensive configuration options
- 🧪 **Fully Tested**: Comprehensive test suite for reliability

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

[](#installation)

### 1. Install the Package

[](#1-install-the-package)

```
composer require usamamuneerchaudhary/filament-notifier
```

### 2. Run the Installation Command

[](#2-run-the-installation-command)

```
php artisan notifier:install
```

This command will:

- Publish the configuration file
- Run the necessary migrations
- Create sample notification channels and templates
- Set up the basic structure

### 3. Register the Plugin

[](#3-register-the-plugin)

Add the plugin to your Filament panel configuration:

```
use Usamamuneerchaudhary\Notifier\FilamentNotifierPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentNotifierPlugin::make(),
        ]);
}
```

After registration, you'll have access to:

- **Notifier Dashboard** - Comprehensive analytics and metrics
- **Notification Settings** - Configure preferences, analytics, and rate limiting
- **Notification Resources** - Manage channels, events, templates, and notifications

### 4. Configure Channels

[](#4-configure-channels)

Update your `.env` file with your notification channel settings:

```
# Email Configuration
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@example.com
MAIL_FROM_NAME="Your App"

# Notifier Package Settings
NOTIFIER_EMAIL_ENABLED=true
NOTIFIER_SLACK_ENABLED=false
NOTIFIER_SMS_ENABLED=false

# Slack Configuration
SLACK_WEBHOOK_URL=https://hooks.slack.com/services/YOUR/WEBHOOK/URL
SLACK_CHANNEL=#notifications

# SMS Configuration (Twilio)
TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token
TWILIO_PHONE_NUMBER=+1234567890
```

Usage
-----

[](#usage)

### Basic Notification Sending

[](#basic-notification-sending)

```
use Usamamuneerchaudhary\Notifier\Facades\Notifier;

// Send a notification using the facade
Notifier::send($user, 'user.registered', [
    'name' => $user->name,
    'email' => $user->email,
]);

// Or using the service directly
$notifier = app('notifier');
$notifier->send($user, 'user.registered', [
    'name' => $user->name,
    'email' => $user->email,
]);
```

### Using Service Facades

[](#using-service-facades)

The package provides convenient facades for accessing services:

```
use Usamamuneerchaudhary\Notifier\Facades\Preference;
use Usamamuneerchaudhary\Notifier\Facades\Analytics;
use Usamamuneerchaudhary\Notifier\Facades\UrlTracking;
use Usamamuneerchaudhary\Notifier\Facades\NotificationRepo;

// Get user preferences
$preferences = Preference::getUserPreferences($user, 'user.registered');

// Check analytics status
if (Analytics::isEnabled()) {
    Analytics::trackOpen($notification);
}

// Safely redirect URLs
return UrlTracking::safeRedirect('https://example.com');

// Find notification by token
$notification = NotificationRepo::findByToken($token);
```

**Note:** After installing the package, run `composer dump-autoload` to register the facades.

### Dependency Injection (Recommended)

[](#dependency-injection-recommended)

For better testability, use dependency injection in your controllers and services:

```
use Usamamuneerchaudhary\Notifier\Services\PreferenceService;
use Usamamuneerchaudhary\Notifier\Services\AnalyticsService;

class MyController extends Controller
{
    public function __construct(
        protected PreferenceService $preferenceService,
        protected AnalyticsService $analyticsService
    ) {}

    public function index()
    {
        $preferences = $this->preferenceService->getUserPreferences($user, 'event.key');

        if ($this->analyticsService->isEnabled()) {
            // Do something
        }
    }
}
```

### Scheduled Notifications

[](#scheduled-notifications)

```
use Carbon\Carbon;

// Schedule a notification for later
$notifier->schedule($user, 'reminder.email', Carbon::now()->addDays(7), [
    'task_name' => 'Complete project review',
]);
```

### Event-Based Notifications

[](#event-based-notifications)

Register events in your `config/notifier.php`:

```
'events' => [
    'user.registered' => [
        'channels' => ['email', 'slack'],
        'template' => 'welcome-email',
    ],
    'order.completed' => [
        'channels' => ['email', 'sms'],
        'template' => 'order-confirmation',
    ],
],
```

### Creating Templates

[](#creating-templates)

Templates can be created through the Filament admin panel or programmatically:

```
use Usamamuneerchaudhary\Notifier\Models\NotificationTemplate;

NotificationTemplate::create([
    'title' => 'Welcome Email',
    'key' => 'welcome-email',
    'type' => 'email',
    'subject' => 'Welcome to {{app_name}}, {{name}}!',
    'content' => 'Hi {{name}},\n\nWelcome to {{app_name}}! We\'re excited to have you on board.',
    'variables' => [
        'name' => 'User\'s full name',
        'app_name' => 'Application name',
    ],
]);
```

### Custom Channel Drivers

[](#custom-channel-drivers)

Create custom channel drivers by implementing the `ChannelDriverInterface`:

```
use Usamamuneerchaudhary\Notifier\Services\ChannelDrivers\ChannelDriverInterface;
use Usamamuneerchaudhary\Notifier\Models\Notification;

class CustomChannelDriver implements ChannelDriverInterface
{
    public function send(Notification $notification): bool
    {
        // Your custom sending logic here
        return true;
    }

    public function validateSettings(array $settings): bool
    {
        // Validate your channel settings
        return !empty($settings['api_key'] ?? null);
    }
}
```

### User Preferences API

[](#user-preferences-api)

The package provides a simple REST API for users to manage their notification preferences. All endpoints require authentication and respect the `allow_override` setting configured in the admin panel.

#### Get All User Preferences

[](#get-all-user-preferences)

```
GET /api/notifier/preferences
Authorization: Bearer {token}
```

**Response:**

```
{
  "data": [
    {
      "event_key": "user.registered",
      "event_name": "User Registered",
      "event_group": "User",
      "description": "Sent when a new user registers",
      "channels": {
        "email": true,
        "sms": false,
        "push": true
      }
    }
  ]
}
```

#### Get Available Events and Channels

[](#get-available-events-and-channels)

```
GET /api/notifier/preferences/available
Authorization: Bearer {token}
```

**Response:**

```
{
  "data": {
    "events": [
      {
        "key": "user.registered",
        "name": "User Registered",
        "group": "User",
        "description": "Sent when a new user registers",
        "default_channels": ["email"]
      }
    ],
    "channels": [
      {
        "type": "email",
        "title": "Email",
        "icon": "heroicon-o-envelope"
      },
      {
        "type": "sms",
        "title": "SMS",
        "icon": "heroicon-o-device-phone-mobile"
      }
    ]
  }
}
```

#### Get Preference for Specific Event

[](#get-preference-for-specific-event)

```
GET /api/notifier/preferences/{eventKey}
Authorization: Bearer {token}
```

**Example:**

```
GET /api/notifier/preferences/user.registered
```

**Response:**

```
{
  "data": {
    "event_key": "user.registered",
    "event_name": "User Registered",
    "event_group": "User",
    "description": "Sent when a new user registers",
    "channels": {
      "email": true,
      "sms": false
    }
  }
}
```

#### Update Preference for Event

[](#update-preference-for-event)

```
PUT /api/notifier/preferences/{eventKey}
Authorization: Bearer {token}
Content-Type: application/json
```

**Request Body:**

```
{
  "channels": {
    "email": true,
    "sms": true,
    "push": false
  },
  "settings": {}
}
```

**Response:**

```
{
  "data": {
    "event_key": "user.registered",
    "event_name": "User Registered",
    "channels": {
      "email": true,
      "sms": true,
      "push": false
    }
  },
  "message": "Preferences updated successfully."
}
```

**Error Responses:**

- `403 Forbidden` - User preference override is disabled by administrator
- `422 Unprocessable Entity` - Invalid channel type or validation error
- `404 Not Found` - Event not found or inactive

**Note:** The API will return a `403` error if the admin has disabled `allow_override` in the notification settings.

Analytics & Tracking
------------------------

[](#analytics--tracking)

The package includes comprehensive analytics tracking for email notifications, allowing you to measure engagement and optimize your notification strategy.

### Email Open Tracking

[](#email-open-tracking)

When `track_opens` is enabled in analytics settings, a 1x1 transparent tracking pixel is automatically injected into all email notifications. When a user opens the email, the pixel loads and tracks the open event.

**Tracking Endpoint:**

```
GET /notifier/track/open/{token}
```

This endpoint:

- Returns a 1x1 transparent PNG pixel
- Records the first open time in `opened_at`
- Increments the `opens_count` counter
- Respects analytics enabled/disabled settings

### Link Click Tracking

[](#link-click-tracking)

When `track_clicks` is enabled, all URLs in email content are automatically rewritten to use tracking URLs. When users click links, the system tracks the click and redirects to the original URL.

**Tracking Endpoint:**

```
GET /notifier/track/click/{token}?url={encoded_url}
```

This endpoint:

- Records the first click time in `clicked_at`
- Increments the `clicks_count` counter
- Safely redirects to the original URL
- Validates URLs to prevent open redirect vulnerabilities

### Analytics Dashboard

[](#analytics-dashboard)

Access the comprehensive analytics dashboard in your Filament admin panel:

**Location:** Navigate to **Notifier → Dashboard** in your Filament admin panel.

**Dashboard Features:**

1. **Overview Stats Widget**

    - Total notifications with trend chart
    - Success rate percentage
    - Pending notifications count
    - Failed notifications count
    - Active channels count
2. **Engagement Stats Widget**

    - Total opens
    - Open rate percentage
    - Total clicks
    - Click rate percentage
    - Click-through rate
3. **Time Series Chart**

    - 30-day line chart showing sent, opened, and clicked notifications
    - Full-width visualization
    - Auto-refreshes every 30 seconds
4. **Engagement Analytics Chart**

    - Combined bar and line chart
    - Shows opens and clicks
    - Overlays open rate % and click rate %
    - Dual Y-axis for counts and percentages
    - Last 7 days view
5. **Channel Performance Chart**

    - Bar chart comparing all active channels
    - Shows sent, opened, and clicked per channel
    - Helps identify best-performing channels
6. **Rate Limiting Status Widget**

    - Real-time usage for minute, hour, and day limits
    - Color-coded warnings
    - Percentage usage indicators
    - Auto-refreshes every 10 seconds

All widgets respect the analytics and rate limiting enabled/disabled settings.

### Data Retention

[](#data-retention)

Configure data retention in the analytics settings. Use the cleanup command to remove old analytics data:

```
# Clean up analytics data older than retention period
php artisan notifier:cleanup-analytics

# Dry run to see what would be cleaned
php artisan notifier:cleanup-analytics --dry-run
```

The cleanup command:

- Respects the `retention_days` setting
- Anonymizes analytics data
- Can be scheduled via Laravel's task scheduler

Rate Limiting
-------------

[](#rate-limiting)

The package includes built-in rate limiting to prevent notification abuse and ensure system stability.

### Configuration

[](#configuration)

Configure rate limits in the Filament admin panel under **Notifier → Settings → Rate Limiting**:

- **Max Per Minute**: Maximum notifications allowed per minute (default: 60)
- **Max Per Hour**: Maximum notifications allowed per hour (default: 1000)
- **Max Per Day**: Maximum notifications allowed per day (default: 10000)

### How It Works

[](#how-it-works)

Rate limiting is enforced before notification creation:

- All three limits (minute, hour, day) are checked
- If any limit is exceeded, notification creation is blocked
- Rate limit violations are logged for monitoring
- Counters are tracked using Laravel Cache with appropriate TTL

### Monitoring

[](#monitoring)

View real-time rate limiting status in the **Notifier Dashboard**:

- Current usage vs limits for each time period
- Color-coded warnings (red >90%, yellow >75%, green otherwise)
- Percentage usage indicators

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

[](#configuration-1)

### Channel Configuration

[](#channel-configuration)

```
// config/notifier.php
'channels' => [
    'email' => [
        'enabled' => true,
        'driver' => 'smtp',
        'from_address' => 'noreply@example.com',
        'from_name' => 'Your App',
    ],
    'slack' => [
        'enabled' => true,
        'webhook_url' => env('SLACK_WEBHOOK_URL'),
        'channel' => '#notifications',
    ],
    'sms' => [
        'enabled' => true,
        'driver' => 'twilio',
        'account_sid' => env('TWILIO_ACCOUNT_SID'),
        'auth_token' => env('TWILIO_AUTH_TOKEN'),
        'phone_number' => env('TWILIO_PHONE_NUMBER'),
    ],
],
```

### Event Configuration

[](#event-configuration)

```
'events' => [
    'user.registered' => [
        'channels' => ['email', 'slack'],
        'template' => 'welcome-email',
        'delay' => 0, // Send immediately
    ],
    'order.shipped' => [
        'channels' => ['email', 'sms'],
        'template' => 'order-shipped',
        'delay' => 300, // 5 minutes delay
    ],
],
```

Database Tables
---------------

[](#database-tables)

The package creates the following database tables with the `notifier_` prefix to avoid conflicts with Laravel's built-in tables:

- `notifier_channels` - Stores notification channel configurations
- `notifier_events` - Stores notification event definitions
- `notifier_templates` - Stores notification templates
- `notifier_preferences` - Stores user notification preferences
- `notifier_notifications` - Stores sent notifications
- `notifier_settings` - Stores global notification settings

**Note:** These tables are separate from Laravel's built-in `notifications` table, which is used for database notifications. Our package provides a comprehensive notification management system that works alongside Laravel's native notification system.

### Publishing Migrations

[](#publishing-migrations)

To customize migrations (e.g., for UUID support, different indexes, or schema changes):

```
php artisan vendor:publish --tag=notifier-migrations
```

After publishing, edit the migration files in `database/migrations/` and run:

```
php artisan migrate
```

API Reference
-------------

[](#api-reference)

### NotifierManager

[](#notifiermanager)

#### Methods

[](#methods)

- `send($user, string $eventKey, array $data = [])`: Send a notification
- `sendNow($user, string $eventKey, array $data = [])`: Send immediately without queuing
- `sendToChannel($user, string $eventKey, string $channelType, array $data = [])`: Send to a specific channel
- `schedule($user, string $eventKey, Carbon $scheduledAt, array $data = [])`: Schedule a notification
- `registerChannel(string $type, $handler)`: Register a custom channel driver
- `registerEvent(string $key, array $config)`: Register an event configuration
- `getRegisteredChannels()`: Get all registered channel types
- `getRegisteredEvents()`: Get all registered event keys

### Available Facades

[](#available-facades)

#### Preference Facade

[](#preference-facade)

```
use Usamamuneerchaudhary\Notifier\Facades\Preference;

Preference::getUserPreferences($user, string $eventKey): array
Preference::getChannelsForEvent(NotificationEvent $event, ?NotificationPreference $preference): array
Preference::shouldSendToChannel($user, string $channelType, array $preferences): bool
```

#### Analytics Facade

[](#analytics-facade)

```
use Usamamuneerchaudhary\Notifier\Facades\Analytics;

Analytics::isEnabled(): bool
Analytics::isOpenTrackingEnabled(): bool
Analytics::isClickTrackingEnabled(): bool
Analytics::generateTrackingPixel(string $trackingToken): string
Analytics::trackOpen(Notification $notification): void
Analytics::trackClick(Notification $notification): void
```

#### UrlTracking Facade

[](#urltracking-facade)

```
use Usamamuneerchaudhary\Notifier\Facades\UrlTracking;

UrlTracking::safeRedirect(string $url): RedirectResponse
UrlTracking::rewriteUrlsForTracking(string $content, string $token): string
```

#### NotificationRepo Facade

[](#notificationrepo-facade)

```
use Usamamuneerchaudhary\Notifier\Facades\NotificationRepo;

NotificationRepo::findByToken(string $token): ?Notification
```

### Models

[](#models)

#### NotificationChannel

[](#notificationchannel)

- `title`: Channel display name
- `type`: Channel type (email, sms, slack, etc.)
- `icon`: Icon for the channel
- `is_active`: Whether the channel is active
- `settings`: Channel-specific settings

#### NotificationTemplate

[](#notificationtemplate)

- `title`: Template display name
- `key`: Unique template identifier
- `type`: Template type
- `subject`: Email subject line
- `content`: Template content with variable placeholders
- `variables`: Available variables for the template

#### Notification

[](#notification)

- `notification_template_id`: Associated template
- `user_id`: Target user
- `channel`: Channel type
- `subject`: Rendered subject
- `content`: Rendered content
- `status`: Notification status (pending, sent, failed)
- `scheduled_at`: Scheduled send time
- `sent_at`: Actual send time
- `opened_at`: First time notification was opened (analytics)
- `clicked_at`: First time a link was clicked (analytics)
- `opens_count`: Total number of opens (analytics)
- `clicks_count`: Total number of clicks (analytics)

Testing
-------

[](#testing)

### Running Tests

[](#running-tests)

```
composer test
```

The package includes comprehensive tests covering:

- Notification sending and scheduling
- User preferences and API endpoints
- Analytics tracking (opens, clicks)
- Rate limiting enforcement
- Email driver functionality
- Analytics cleanup command

### Test Coverage

[](#test-coverage)

**Feature Tests:**

- `NotifierManagerTest` - Core notification functionality
- `AnalyticsTrackingTest` - Email open and click tracking
- `RateLimitingTest` - Rate limit enforcement
- `AnalyticsCleanupCommandTest` - Data retention cleanup

**Unit Tests:**

- `RateLimitingServiceTest` - Rate limiting service logic
- `EmailDriverTest` - Email sending and tracking pixel injection

### Sending Test Notifications

[](#sending-test-notifications)

You can send test notifications using the provided command:

```
# Send a test notification
php artisan notifier:test user.registered --user=1

# Send with custom data
php artisan notifier:test user.registered --user=1 --data="name=John Doe" --data="app_name=Test App"

# Send to specific channel
php artisan notifier:test user.registered --user=1 --channel=email
```

Available Commands
------------------

[](#available-commands)

- `php artisan notifier:install` - Install the package and create sample data
- `php artisan notifier:test {event} [options]` - Send test notifications
- `php artisan notifier:cleanup-analytics [--dry-run]` - Clean up old analytics data based on retention settings

### Cleanup Analytics Command

[](#cleanup-analytics-command)

The cleanup command removes or anonymizes analytics data older than the configured retention period:

```
# Clean up old analytics data
php artisan notifier:cleanup-analytics

# Preview what would be cleaned (dry run)
php artisan notifier:cleanup-analytics --dry-run
```

**Options:**

- `--dry-run`: Show what would be cleaned without actually deleting data

**What it does:**

- Finds notifications with analytics data older than `retention_days`
- Anonymizes the data (sets opens/clicks to 0, clears timestamps)
- Preserves notification records for historical reference
- Respects the `analytics.enabled` setting

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

[](#contributing)

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE.md).

Architecture & Design
-------------------------

[](#architecture--design)

The package follows Laravel best practices with a clean, service-oriented architecture:

- **Service Classes**: Regular classes that can be dependency injected or accessed via facades
- **Facades**: Convenient static access to services (registered in `composer.json`)
- **Dependency Injection**: Preferred approach for controllers and testable code
- **Service Container**: All services are registered as singletons for optimal performance

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

[](#screenshots)

### Dashboard Overview

[](#dashboard-overview)

 [![Dashboard Overview](public/images/screenshots/Screenshot 2025-12-19 at 23.28.25.png)]()

### Analytics & Metrics

[](#analytics--metrics)

 [![Analytics Dashboard](public/images/screenshots/Screenshot 2025-12-19 at 23.28.31.png)]() [![Engagement Metrics](public/images/screenshots/Screenshot 2025-12-19 at 23.28.36.png)]()### Notification Management

[](#notification-management)

 [![Notification Channels](public/images/screenshots/Screenshot 2025-12-19 at 23.28.51.png)]() [![Notification Events](public/images/screenshots/Screenshot 2025-12-19 at 23.28.59.png)]()### Templates & Settings

[](#templates--settings)

 [![Notification Templates](public/images/screenshots/Screenshot 2025-12-19 at 23.29.04.png)]() [![Notification Settings](public/images/screenshots/Screenshot 2025-12-19 at 23.29.12.png)]()Support
-------

[](#support)

For support, please open an issue on GitHub or contact me at .

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance82

Actively maintained with recent releases

Popularity33

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity50

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

Total

4

Last Release

89d ago

PHP version history (2 changes)1.0PHP ^8.3

v1.1PHP ^8.2

### Community

Maintainers

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

---

Top Contributors

[![usamamuneerchaudhary](https://avatars.githubusercontent.com/u/24513380?v=4)](https://github.com/usamamuneerchaudhary "usamamuneerchaudhary (57 commits)")

---

Tags

phplaravelnotificationsfilamentfilamentphpusamamuneerchaudhary

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/usamamuneerchaudhary-filament-notifier/health.svg)

```
[![Health](https://phpackages.com/badges/usamamuneerchaudhary-filament-notifier/health.svg)](https://phpackages.com/packages/usamamuneerchaudhary-filament-notifier)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[laravel-notification-channels/telegram

Telegram Notifications Channel for Laravel

1.1k3.4M35](/packages/laravel-notification-channels-telegram)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[guava/filament-modal-relation-managers

Allows you to embed relation managers inside filament modals.

7565.0k4](/packages/guava-filament-modal-relation-managers)[tapp/filament-google-autocomplete-field

Filament plugin that provides a Google Autocomplete field

3098.1k](/packages/tapp-filament-google-autocomplete-field)

PHPackages © 2026

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