Loading page...

Frostal.us

Docs: Posts

Reference notes for the Frostal post system, composer flow, comments, mentions, and standalone post pages.

Page overview

  • Posts are part of Frostal profile activity and community feed rendering.
  • Users can create new posts from /profile/post/new.
  • Standalone public post pages live under /posts/:postId and include comments and reactions.

Composer flow

  • The composer supports rich-text style source with preview behavior.
  • Posts can include image attachments through the current profile-post flow.
  • Comment creation uses the same mention-aware text normalization path as post creation.

Mentions and comments

  • @username works in new posts and comments.
  • Matching usernames are rewritten to canonical profile links on save.
  • Older plain-text mentions still upgrade at render time as a legacy fallback.
  • Users cannot mention themselves for self-links or self-notifications inside their own posts/comments.
  • Post and comment mentions create notifications for the mentioned user.
  • When someone comments on a user's post, the post owner also receives a notification with a jump link to that comment.
  • When another user adds a 👍 or 👎 reaction to a post or comment, the content owner receives a reaction notification.

Internal routes

These routes are part of Frostal's internal post system. They are not documented here as public third-party APIs.

/api/user/posts
Internal authenticated route for post creation, deletion, and post reaction flow.
/api/user/post-comments
Internal authenticated route for comment creation and deletion in post discussions.
/posts/:postId
Standalone Frostal post page with rendered post body, comments, and per-post actions.