Crafting a Scalable Newsletter System with Laravel and Filament

On the devlog-ist/landing project, we recently implemented a comprehensive weekly newsletter digest system designed to keep users engaged with fresh content. The goal was to build a robust, configurable, and secure system capable of handling subscriptions, content delivery, and user management efficiently.

The Challenge: Building a Robust Newsletter System

Developing a newsletter system isn't just about sending emails. It involves several interconnected challenges: managing subscribers, ensuring timely delivery, handling potential spam, providing an unsubscribe flow, and offering administrative oversight. For our landing project, we needed a solution that was integrated, secure, and performant.

The Components of Our Solution

To address these challenges, we leveraged several powerful tools within the Laravel ecosystem:

• Frontend Subscription: Integrated a newsletter subscription form across all portfolio themes (default, simple, nan). This form utilizes Livewire components for a dynamic user experience.
• Security with reCAPTCHA v3: To prevent spam and abuse, we implemented reCAPTCHA v3 protection on the subscription form, active only in production environments. This ensures that only legitimate users can subscribe.
• Subscriber Management: An administrative interface for managing subscribers was crucial. We built a dedicated Filament resource, allowing administrators to easily view, add, edit, or remove subscribers.
• Unsubscribe Flow: A secure and user-friendly unsubscribe process was paramount. This was achieved using signed URLs to ensure authenticity and a dedicated confirmation page for a clear user experience.

Scheduling and Queuing for Scale

One of the core requirements was a weekly digest email, configurable per tenant for specific days and times. To achieve this, we combined Laravel's scheduling and queuing capabilities:

• Artisan Command: An Artisan command was created to dispatch the digest jobs. This command iterates through tenants, checks their configured send times, and dispatches jobs accordingly.

// app/Console/Commands/DispatchWeeklyDigests.php
namespace App\Console\Commands;

use App\Jobs\SendWeeklyDigest;
use App\Models\Tenant;
use Illuminate\Console\Command;
use Carbon\Carbon;

class DispatchWeeklyDigests extends Command
{
    protected $signature = 'digests:dispatch-weekly';
    protected $description = 'Dispatches weekly newsletter digest jobs for all active tenants.';

    public function handle(): void
    {
        $this->info('Dispatching weekly digest jobs...');

        Tenant::active()->each(function (Tenant $tenant) {
            // Example: check if it's the tenant's configured day and hour
            if ($tenant->prefersDigestToday(Carbon::now())) {
                SendWeeklyDigest::dispatch($tenant->id)->onQueue('newsletters');
                $this->comment("Dispatched for tenant: {" . $tenant->name . "}");
            }
        });

        $this->info('Digest dispatch complete.');
    }
}

This command orchestrates the process of identifying which tenants are due for a digest and initiating the email sending process.

• Hourly Schedule: The Artisan command is scheduled to run hourly using Laravel's task scheduler, ensuring timely checks for digest dispatches.

// app/Console/Kernel.php
protected function schedule(Schedule $schedule): void
{
    $schedule->command('digests:dispatch-weekly')
             ->hourly()
             ->withoutOverlapping();
}

This simple scheduling ensures that the dispatch logic runs regularly without overlapping instances.

• Horizon Queue: For asynchronous and reliable processing of newsletter emails, we configured Horizon to manage the newsletters queue. This offloads the heavy lifting of sending emails to dedicated queue workers, preventing bottlenecks and ensuring a smooth user experience.

The Takeaway

Building complex features like a newsletter system becomes significantly more manageable and robust when leveraging the integrated ecosystem of Laravel. By combining features like Livewire forms, Filament for administration, scheduled Artisan commands, and Horizon for queue management, you can create a scalable, secure, and user-friendly system with minimal friction. Always consider how each component of the Laravel stack can solve a specific part of your application's requirements, from frontend to background processing.