evanschleret/notificationcompass

Context-aware notification preferences for Laravel applications.

dev-main 2026-07-26 16:01 UTC

Requires

• php: ^8.2
• illuminate/database: ^11.0|^12.0
• illuminate/notifications: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^9.0|^10.0
• phpunit/phpunit: ^10.0|^11.0|^12.0

MIT

• Evan Schleret

Published on Packagist.org on 2026-07-30 14:07 UTC

README

NotificationCompass is a Laravel package for managing notification preferences above Laravel's native notification system.

It helps applications decide whether a notification should be sent to a user, through a channel, and in an optional business context. It supports global and context-specific preferences, defaults, opt-in notifications, and mandatory notifications while remaining independent from application-specific domain models.

Status

This package is currently under development. The public API and supported Laravel versions may change before the first stable release.

Installation

Installation will be available through Composer once the package is released. Until then, follow the repository's development instructions.

Documentation

The functional specification describes the package goals, concepts, resolution rules, and indicative PHP API.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening an issue or pull request.

Security

Please report vulnerabilities privately. See SECURITY.md for the reporting process.

License

NotificationCompass is released under the MIT License.