laravel-afterburner/communications

Team announcements, discussion threads, and communication log for Afterburner applications

1.0.0 2026-05-29 13:53 UTC

Requires

• php: ^8.2
• laravel-afterburner/jetstream: ^1.0|dev-master
• laravel/framework: ^11.0
• livewire/livewire: ^3.5

Requires (Dev)

• laravel/pint: ^1.13
• orchestra/testbench: ^9.0
• phpunit/phpunit: ^11.0

MIT

README

Team-scoped announcements, discussion threads, and outbound communication log for Laravel Afterburner Jetstream.

Features

• Announcements — role-targeted posts, read tracking, scheduled email (announcements:send-scheduled)
• Discussion threads — scopes: council, team, property (optional lot link)
• Communication log — auditable outbound record (email / in-app / system), separate from AuditService

Installation

Local Development Setup

For local development, add the package as a path repository:

composer config repositories.afterburner-communications path ../afterburner-communications
composer require laravel-afterburner/communications:@dev

Quick Install (Recommended)

composer require laravel-afterburner/communications
php artisan afterburner:communications:install

The install command will:

• Publish config and views
• Add communications environment variables to .env and .env.example when present
• Optionally run migrations and seed permissions

Manual Install

php artisan vendor:publish --tag=afterburner-communications-config
php artisan vendor:publish --tag=afterburner-communications-assets
php artisan migrate
php artisan db:seed --class="Afterburner\\Communications\\Database\\Seeders\\CommunicationsPermissionsSeeder"

If you use migrate:fresh --seed, register CommunicationsPermissionsSeeder with your app's PackageSeederRegistry (or call it from DatabaseSeeder) so discussion and communication-log permissions are assigned beyond the default role templates.

Configuration

Environment variables (added by the install command):

AFTERBURNER_COMMUNICATIONS_ENABLED=true
AFTERBURNER_COMMUNICATIONS_ANNOUNCEMENTS_ENABLED=true
AFTERBURNER_COMMUNICATIONS_DISCUSSIONS_ENABLED=true
AFTERBURNER_COMMUNICATIONS_LOG_ENABLED=true

Package options live in config/afterburner-communications.php. Discussions default on when afterburner.entity_label is strata.

Permissions

Slug	Purpose
post_announcements	Host RoleTemplates (unchanged)
manage_discussions	Create / lock threads
view_communication_log	Team communication log UI

Seeded via CommunicationsPermissionsSeeder (registered with PackageSeederRegistry).

Events (host listeners)

• AnnouncementPublished
• ThreadCreated
• CommunicationLogged

Scheduled Tasks

Register in your host app:

$schedule->command('announcements:send-scheduled')->everyMinute();

License

MIT License