Community & Feed
The community features let members share posts, interact through likes and comments, and browse the member directory. Staff can moderate content and manage community visibility.
Community Feed
How Posts Work
Members create posts from the mobile app. Each post can include text content (up to 2,000 characters) and an optional photo. Posts appear in the community feed for all academy members to see.
Post Status Workflow
Posts follow a status-based workflow depending on the author's role and your academy's moderation settings:
Staff posts (owner, admin, instructor): Always published immediately — no approval needed.
Student posts:
- If Student Posts Require Approval is enabled (the default): Posts are created with "Pending Approval" status and must be approved by staff before they appear in the feed.
- If the setting is disabled: Student posts are published immediately, just like staff posts.
You can configure this setting in Academy Settings.
Creating Posts (Mobile App)
Open the create post screen
From the Community tab on the mobile app, tap the compose button to open the post creation screen.
Write your post
Enter your text content (up to 2,000 characters). A character counter shows how many characters remain.
Add a photo (optional)
Tap the photo button to select an image from your camera roll. The image is compressed before uploading for optimal performance. A preview appears with a remove button if you change your mind.
Submit
Tap Post to submit. If you're a student and approval is required, you'll see a message confirming your post was submitted for review.
Students see a review notice
When student post approval is enabled, students see the message: "Your post will be reviewed by staff before appearing in the feed." This sets clear expectations about the moderation process.
Moderating Posts (Web Dashboard)
Staff members moderate the community feed from the Feed page in the web dashboard sidebar.
Two-Tab Interface
Published Tab: Shows all published posts in reverse chronological order (newest first). Each post card displays the author's avatar and name, relative timestamp, post body, image (if any), and like/comment counts.
Pending Review Tab: Shows posts awaiting approval. A red badge on the tab indicates the number of pending posts. Pending posts are styled with an amber left border for quick visual identification.
Approving Posts
Navigate to the Pending Review tab
The badge count tells you how many posts are waiting.
Review the post content
Read the post body and view any attached image to ensure it meets your community guidelines.
Approve or reject
Click Approve to publish the post (it becomes visible to all members) or Reject to hide it permanently. The system records who moderated the post and when.
Deleting Posts
From the Published tab, staff can delete any post using the dropdown menu. The original author can also delete their own posts. When a post is deleted:
- The post is removed from the feed
- All associated comments and likes are removed
- If the post had an image, it's cleaned up from storage
Community Tab (Mobile App)
The Community tab on the mobile app has two sub-tabs:
Posts Tab
A scrollable feed of published posts showing:
- Author avatar (or initials) and name
- Relative timestamp ("2h ago", "3d ago")
- Post body text
- Image (if attached, displayed at a consistent height)
- Like and comment counts
Tapping a post opens the full post detail screen.
Members Tab
A searchable directory of all academy members:
- Search bar to filter by name
- Filters (via bottom sheet):
- Belt rank — All, White, Blue, Purple, Brown, Black
- Role — All, Owner, Admin, Instructor, Student (staff-only filter)
- 30-day Attendance — All, High (8+), Medium (4-7), Low (1-3), None (staff-only filter)
Each member card shows their avatar, name, belt rank with colored indicator and stripes, and (for staff viewing) their subscription status badge.
Visibility rules:
- Students can see members with "Academy" (gym_only) visibility and themselves
- Students cannot see members who set their profile to "Private"
- Staff can see all members regardless of visibility setting
Tapping a member card opens their profile detail screen.
Post Detail Screen (Mobile App)
The full post detail screen shows:
- Complete post content and image
- Like button (tap to toggle — optimistic UI with instant feedback)
- Comment section showing all comments with author names and timestamps
- Comment input at the bottom for adding new comments
- Pull-to-refresh for updates
Likes
- Tap the heart icon to like/unlike a post
- The like count updates instantly (optimistic UI)
- Each member can like a post only once
Comments
- Type a comment in the input field and tap send
- Comments show the author name and relative timestamp
- Deleting comments: The comment author can delete their own comments; instructors and above can delete any comment
- Comments include a confirmation dialog before deletion
Permissions
| Feature | Owner | Admin | Instructor | Student |
|---|---|---|---|---|
| View published posts | Yes | Yes | Yes | Yes |
| Create posts | Yes | Yes | Yes | Yes |
| Auto-publish posts | Yes | Yes | Yes | If disabled |
| Like posts | Yes | Yes | Yes | Yes |
| Comment on posts | Yes | Yes | Yes | Yes |
| Delete own posts | Yes | Yes | Yes | Yes |
| Delete any post | Yes | Yes | No | No |
| Delete any comment | Yes | Yes | Yes | Own only |
| Approve/reject posts | Yes | Yes | Yes | No |
| Access Feed page (web) | Yes | Yes | Yes | No |
| View member directory | Yes | Yes | Yes | Yes |
| Filter by role/attendance | Yes | Yes | Yes | No |
Building community engagement
Encourage instructors to post training tips, technique breakdowns, or class highlights. A lively feed keeps members engaged between training sessions and strengthens your academy culture.