README

BeFuture Scheduled Reminders is a simple, extensible, and reliable scheduled reminder package for Laravel. It stores reminders in the database, processes them when their scheduled time arrives, and dispatches an event so you can send notifications through any channel (email, SMS, push, database, etc.).

Features

Create scheduled reminders easily
Automatically resolve due reminders
Prevent duplicate processing using is_sent flag
Fully event-driven architecture
Publishable config and migrations
UUID-based model
Service-based API
Console command for the scheduler
Complete Testbench integration
PSR-4 & SOLID compliant structure

Installation

composer require befuturein/scheduled-reminders

Laravel automatically discovers the service provider.

Publish Config & Migrations

Run these commands inside your Laravel application:

php artisan vendor:publish --tag=scheduled-reminders-config
php artisan vendor:publish --tag=scheduled-reminders-migrations
php artisan migrate

Configuration

config/scheduled-reminders.php:

return [
    'default_channel' => 'email',

    'channels' => [
        'email',
        'database',
        'sms',
    ],

    'run_interval_minutes' => 5,
];

Scheduler Setup

Add to your scheduler:

// app/Console/Kernel.php

protected function schedule(\Illuminate\Console\Scheduling\Schedule $schedule): void
{
    $schedule->command('scheduled-reminders:send')->everyMinute();
}

Usage (Service API)

Create a reminder

use BeFuture\ScheduledReminders\Services\ReminderService;

$reminder = app(ReminderService::class)->create([
    'title'        => 'Payment Reminder',
    'message'      => 'Please don’t forget your monthly payment.',
    'channel'      => 'email',
    'scheduled_at' => now()->addMinutes(10),
]);

Fetch due reminders

$due = app(ReminderService::class)->dueReminders();

Mark as sent

app(ReminderService::class)->markAsSent($reminder);

Event System

When a reminder is processed, this event is dispatched:

BeFuture\ScheduledReminders\Events\ReminderSent

Example listener:

class LogReminderSent
{
    public function handle(ReminderSent $event)
    {
        logger('Reminder sent', [
            'id' => $event->reminder->id,
        ]);
    }
}

Testing

This package includes full PHPUnit + Orchestra Testbench integration.

Run tests:

vendor/bin/phpunit

Example TestCase

abstract class TestCase extends BaseTestCase
{
    use RefreshDatabase;

    protected function getPackageProviders($app): array
    {
        return [
            ScheduledRemindersServiceProvider::class,
        ];
    }

    protected function defineDatabaseMigrations()
    {
        $this->loadMigrationsFrom(__DIR__ . '/../database/migrations');
    }
}

Directory Structure

src/
    ScheduledRemindersServiceProvider.php
    Services/
    Models/
    Events/
    Console/

config/
database/
tests/
composer.json
phpunit.xml.dist
README.md

Architecture

Namespace: BeFuture\ScheduledReminders
Vendor: befuturein
Fully PSR-4 compliant
UUID-based primary keys
Service container bindings
Event-driven flow
Config-driven channel architecture
Extensible by design for email, SMS, push, queue systems, etc.

Development

composer install
vendor/bin/phpunit

License

MIT License.

About BeFuture Interactive

This package is part of the BeFuture Interactive open-source ecosystem. More packages coming soon.

befuturein / scheduled-reminders

Maintainers

Details