Docs: Posts

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.