Overview
Gainable apps can include collaboration features powered by Weavy. These components are self-contained and work out of the box.Available components
Chat
Real-time group messaging for teams or contexts.- Team discussions
- Project-specific conversations
- Context-based chat (per deal, per task, etc.)
- Real-time messages
- Message history
- Typing indicators
- Read receipts
- Emoji reactions
- File sharing in chat
Messenger
Private direct messaging between users.- One-on-one conversations
- Private discussions
- User-to-user communication
- Conversation list
- Direct messages
- Unread counts
- User presence (online/offline)
- Search conversations
Chat vs Messenger:
- Use Chat for group/contextual conversations (project chat, team chat)
- Use Messenger for private user-to-user messaging (like Slack DMs)
Files
Document upload and sharing.- Document collaboration
- Sharing attachments
- File organization
- Drag-and-drop upload
- File previews
- Download links
- File type icons
- Version history
Comments
Threaded discussions on specific items.- Item-specific discussions
- Feedback and reviews
- Activity logs
- Threaded replies
- @mentions
- Timestamps
- Edit and delete
- Reactions
Posts / Activity Feed
Social-style updates and announcements.- Team updates
- Announcements
- Activity streams
- Create posts
- Comments on posts
- Reactions
- Rich text formatting
- File attachments
Notifications
Notification center for all collaboration activity.- Unread counts
- Notification list
- Mark as read
- Click to navigate
Placement patterns
Page-level
Everyone on the page sees the same component:Item-level
Each item has its own instance:Global
Accessible from anywhere:Examples
Project workspace
CRM with collaboration
Team dashboard
Combining components
You can use multiple collaboration features together:Real-time behavior
All collaboration components are real-time:- Messages appear instantly
- Files show immediately after upload
- Comments update live
- Notifications push automatically
Notifications
Gainable handles notifications automatically:- Toast notifications appear for new messages
- Badge counts show unread items
- Notification center collects all activity
- New messages in their chats
- @mentions in comments
- Replies to their posts
- File shares
Best practices
Match component to use case
Match component to use case
- Chat: Ongoing discussions
- Comments: Item-specific feedback
- Files: Document sharing
- Messenger: Private conversations
Place contextually
Place contextually
Put chat on project pages for project discussions, not floating randomly.
Consider scope
Consider scope
- Global chat can get noisy
- Item-level chat stays focused
- Choose based on your team size and use case
Don't overload pages
Don't overload pages
Pick the collaboration features that make sense. Not every page needs chat, files, and comments.
Layout options
Inline
Component appears directly on the page:Drawer
Component slides out from the side:Modal
Component appears in an overlay:Tab
Component is one tab among several:Learn more
Real-time updates
How real-time works
Building collaboration
Integration patterns