Skip to content

Notifications

The platform delivers notifications in real time via WebSocket and by email.

Notification Types

EventWho receives it
Reply to a commentOriginal comment author
@username mentionMentioned user
Reaction on a postPost author
Reaction on a commentComment author
New post from followed author/communityFollowers with notifications enabled
Comment on a post with notification subscriptionPost subscribers
New followerFollowed user
Private messageMessage recipient
Post unpublishedPost subscribers
Subscription payment succeeded / canceledUser with an active subscription

Author or Community Notification Subscription

In addition to feed follows (POST /follows/{user}), users can enable push notifications for new publications:

  • Subscribe to notifications: POST /notifications (passes author or community)
  • Unsubscribe from notifications: DELETE /notifications

Real-Time Delivery

Notifications are delivered via Laravel Reverb — a WebSocket server built into the platform stack.

When a notification arrives, the bell icon in the header updates without page reload. Clicking it opens the notification list.

Reverb is configured via REVERB_* variables in .env.

Email Notifications

Notifications can be duplicated by email — if the user has enabled the corresponding setting.

For email notifications to work, SMTP must be configured — see Email Configuration.

User Settings

Users manage notifications in Settings → Notifications (/settings):

  • Enable / disable notifications by type
  • Email notifications: enable / disable

Settings are stored in the user_notification_settings table.

Update settings: POST /settings/notification

Notification Management

ActionRoute
Get listGET /notifications
Subscribe to author/community notificationsPOST /notifications
Unsubscribe from notificationsDELETE /notifications
Mark all as readPOST /notifications/readAll
Mark all as seenPOST /notifications/sawAll

Released under the MIT License.