Loading page...

Frostal.us

Docs: Notifications

Reference notes for the notifications inbox and the first live notification types.

Page overview

  • /notifications is a private page and requires login.
  • The current page shows the user inbox for mentions, comments on posts, and post/comment reaction activity.
  • The top-right nav bell links here and reflects unread state.

Internal route notes

These routes support Frostal's own notifications UI. They are internal site interfaces, not public developer endpoints.

/api/user/notifications
Internal authenticated route returning the current user notifications list and unread count.
/api/user/me
Internal current-user payload route that also carries unread notification count for shared topbar state.

Important behavior

  • Live notification types include post mentions, comment mentions, comments posted onto a user's post, and thumbs-up/thumbs-down reactions on posts/comments.
  • Users cannot notify themselves with self mentions.
  • Comment-on-post notifications include who commented, what post it was on, when it happened, and a jump link to the comment.
  • Reaction notifications are created when another user adds either a 👍 or 👎 reaction to a post or comment.
  • Read/unread mutation actions are not implemented yet.