Email Notifications

Email notifications wired to Laravel’s built-in auth events. Each one is queued and individually toggleable via config — turn on only what your project needs.

Supported events

OTP verification dispatches Registered for first-time users (welcome email fires) followed by Login (login alert fires).

Configuration

'auth' => [
    'notifications' => [
        'welcome_email_enabled' => env('AUTH_WELCOME_EMAIL_ENABLED', true),
        'login_notification_enabled' => env('AUTH_LOGIN_NOTIFICATION_ENABLED', true),
        'logout_notification_enabled' => env('AUTH_LOGOUT_NOTIFICATION_ENABLED', false),
        'password_reset_confirmation_enabled' => env('AUTH_PASSWORD_RESET_CONFIRMATION_ENABLED', true),
    ],
],

Each listener checks its flag at the start of handle(), so toggling at runtime takes effect for the next dispatched event without rebooting.

Customising templates

Blade templates live in resources/views/emails/:

Edit the Blade for branding, or swap the mailable for a Notification class if you need database / Slack / SMS channels.

Adding a listener

1. php artisan make:listener SendCustomNotification

2. Implement handle() with a config gate:

   public function handle(MyEvent $event): void
   {
       if (! config('boilerplate.auth.notifications.my_thing_enabled', false)) {
           return;
       }
       Mail::to($event->user)->send(new MyMail);
   }

Listeners in app/Listeners/ are auto-discovered by Laravel — no manual registration. Every listener implements ShouldQueue; run a queue worker in production (QUEUE_CONNECTION=sync runs them inline in tests).