Social Features
Design Philosophy
Privacy by Default
The Convergence Protocol’s social features are built on a foundation of radical privacy and user control:
- All social features are OPT-IN: No social functionality is enabled without explicit, informed consent
- Default state: completely private: New users start with maximum privacy; they must actively choose to share
- No data shared without explicit consent: Every piece of shared data requires user approval
- Can disable anytime, data deleted: Users can exit social features at any moment, with complete data removal
Privacy Promise: We will never:
- Import contacts without permission
- Share data with third parties
- Use social data for advertising
- Make any information public by default
Positive Psychology
Our social features are designed around principles of positive psychology and behavioral science:
- No shame, no guilt: Never make users feel bad for missing a day or falling behind
- Comparison is for motivation, not competition: Show relative progress to inspire, not to create anxiety
- Celebrate progress, not perfection: Acknowledge effort and consistency over flawless execution
- Supportive community over competitive leaderboard: Foster connection and mutual support rather than zero-sum competition
Psychological Safety Principles:
- Frame comparisons as “inspiration” not “ranking”
- Highlight personal growth over relative standing
- Normalize struggle and setbacks as part of the journey
- Celebrate the act of beginning, not just completing
Minimal Friction
Social features should enhance the meditation experience without becoming the focus:
- Simple friend connections: One-tap invites, no complex friend management
- No complex social graph: No followers, no influence scores, no social hierarchy
- Easy sharing, easy opting out: Share in two taps; disable social features in one
- Focus on the journey, not the platform: Social features support the meditation practice, not vice versa
Feature Overview
1. Share Progress
Share Card
A beautifully designed, branded shareable image that users can post to social media or share directly.
Visual Design:
┌─────────────────────────────┐
│ │
│ [Convergence Protocol │
│ Logo/Icon] │
│ │
│ "Day 23 of 40" │
│ │
│ ┌─────────────────┐ │
│ │ [Streak Icon] │ │
│ │ 12-Day Streak │ │
│ └─────────────────┘ │
│ │
│ "The Mirror Stage" │
│ │
│ "The obstacle is the │
│ path." │
│ — Zen Proverb │
│ │
│ [QR Code: Join the Journey]│
│ │
│ convergenceprotocol.io │
└─────────────────────────────┘
Card Elements:
- Day counter (X of 40) with visual progress indicator
- Current streak count with flame or similar icon
- Current day’s theme/title
- Quote from today’s meditation content
- Subtle branding and link
- Optional: QR code for easy joining
Card Variants:
- Milestone Cards: Special designs for Days 7, 14, 21, 30, 40
- Streak Cards: Celebrate streak achievements (7, 14, 21, 30, 40 days)
- Completion Card: Special design for Day 40 finishers with “Guide” status
- Weekly Summary: Aggregate card showing week’s progress
Share Destinations
Native Share Sheet:
- Twitter/X (pre-populated with quote and hashtag)
- Facebook (optimized image size)
- LinkedIn (professional growth framing)
- Instagram Stories (vertical format)
- WhatsApp/Telegram (direct message)
- Copy link
- Download image (save to device)
Platform-Specific Copy:
Twitter/X:
Day 23 of 40 in The Convergence Protocol 🧘
"The obstacle is the path."
12-day streak going strong. This journey is transforming how I relate to myself.
#ConvergenceProtocol #MeditationJourney #Day23
[link]
LinkedIn:
40 days of intentional practice. Day 23 complete.
The Convergence Protocol isn't just meditation—it's a structured journey of self-discovery. Today's theme: The Mirror Stage.
Consistency compounds. What's your daily practice?
#Mindfulness #PersonalGrowth #ConvergenceProtocol
[link]
WhatsApp/Telegram:
Hey! I'm on Day 23 of a 40-day meditation journey. It's been incredible—12 days straight now.
Want to join me? We could do this together: [link]
Share Triggers
Automatic Prompts (can be disabled):
- After completing a day’s meditation
- When hitting streak milestones (7, 14, 21, 30, 40)
- Weekly summary (every 7 days)
- Upon journey completion (Day 40)
Manual Sharing:
- Share button always available in app
- Can share any previous day’s quote
- Can share without completing (“I’m starting this journey”)
Smart Timing:
- Prompt appears after meditation completion (not before)
- 3-second delay to allow completion feeling to land
- One-tap dismiss if user not interested
- “Don’t ask again today” option
2. Friend Connections
Adding Friends
Invite Link Method:
- User taps “Invite Friend” in social settings
- System generates unique invite code:
convergence://join/ABC123XYZ - User shares via any platform
- Friend taps link → opens app → sees connection request
- Friend accepts → mutual connection established
QR Code Method:
- User displays personal QR code
- Friend scans with app camera
- Connection request sent
- User accepts → connection established
Manual Code Entry:
- User receives friend’s code (e.g., “SUNRISE42”)
- Enters code in “Add Friend” field
- System validates and sends request
- Friend accepts → connection established
Important: No contact import. Users must intentionally share and accept connections.
Friend List
Friend Card Display:
┌─────────────────────────────────────┐
│ 🧘 Sarah Chen [•••] │
│ │
│ Day 23 of 40 ████████████░░░░░░░ │
│ 🔥 12-day streak │
│ Last active: Today │
│ │
│ [Send Encouragement] │
└─────────────────────────────────────┘
Information Shown:
- Display name (user-chosen or anonymous)
- Avatar (emoji selection or default)
- Current day in journey (X of 40)
- Visual progress bar
- Current streak count
- Last active status (Today / Yesterday / This week / Longer)
- Quick action: Send encouragement
Friend List Organization:
- Sort by: Last active (default), Day progress, Streak length
- Group by: Active today / Active this week / Less active
- Filter: All / Active now / On same day / Ahead / Behind
Privacy Levels
Users choose their privacy level independently for each type of data:
Progress Visibility:
- Private: No one sees your progress (default)
- Friends Only: Only connected friends see your day/streak
- Anonymous Public: Progress visible to all, identity hidden (shown as “Meditator #1234”)
Granular Controls:
privacySettings: {
progressVisibility: "private" | "friends" | "anonymous",
streakVisibility: "private" | "friends",
nameVisibility: "private" | "friends" | "anonymous",
allowEncouragement: "nobody" | "friends",
showLastActive: false | true
}Changing Privacy:
- One-tap privacy level change in settings
- Changes apply immediately
- Friends notified of privacy change (“Sarah is now sharing anonymously”)
3. Progress Comparison
”Who’s Ahead” Comparisons
Comparison Messages (designed to inspire, not shame):
When you’re ahead:
- “You’re 3 days ahead of Sarah. Keep leading the way!”
- “You’ve been consistent—5 days ahead of your friend Mike.”
- “You’re blazing the trail! 7 days ahead of the pack.”
When a friend is ahead:
- “Sarah just completed Day 25! Inspiration to keep going.”
- “Mike is on a 14-day streak—impressive dedication.”
- “Your friend Alex reached Day 30. The finish line is in sight for them!”
When converged (same day):
- “You and Sarah are both on Day 20—convergence!”
- “You and 3 friends are all on Day 15. Synchronized journey!”
- “Convergence moment: You and Mike reached Day 30 together.”
When behind (framed positively):
- “Sarah started a week before you—her progress inspires!”
- “Mike is on Day 30. When you get there, you’ll have a guide.”
- “Everyone moves at their own pace. Your Day 15 is just as meaningful.”
Comparison Display:
┌─────────────────────────────────────┐
│ Journey Comparisons │
│ │
│ 🏃 Ahead of you: │
│ Sarah (Day 25) - 3 days ahead │
│ Mike (Day 30) - 8 days ahead │
│ │
│ 🤝 Same day as you: │
│ Alex (Day 22) - Convergence! │
│ │
│ 🚶 Behind you: │
│ Jamie (Day 18) - 4 days behind │
│ │
│ [View Journey Map] │
└─────────────────────────────────────┘
Journey Map View
A visual representation of friends’ positions on the 40-day path.
Visual Design:
Day 1 Day 40
| |
[•]────[•]────[•]────[•]────[•]────[•]────[•]────[★]
| | | | | | | |
You Mike Sarah Alex -- -- -- Guides
(22) (30) (25) (22) [🧘x12]
Legend:
• = Day marker
★ = Completion
🧘 = Guide (completed journey)
-- = No friends at this stage
Interactive Elements:
- Tap any friend marker to see their card
- Tap “Guides” to see Day 40 finishers
- Zoom to see cluster details
- Filter by: All friends / Active recently / Same cohort
Cluster Display: When multiple friends are at the same day:
- Show count badge: “3 friends here”
- Tap to expand and see names
- “Convergence moment” celebration for 2+ friends on same day
Streak Leaderboard (Friends Only)
Current Streak Ranking:
┌─────────────────────────────────────┐
│ Friend Streaks 🔥 │
│ │
│ 1. Mike ............... 14 days │
│ 2. You ................ 12 days │
│ 3. Sarah .............. 8 days │
│ 4. Alex ............... 3 days │
│ 5. Jamie .............. 1 day │
│ │
│ [View Longest Streaks] │
└─────────────────────────────────────┘
Longest Streak Ranking:
- Shows all-time best streaks
- Encourages consistency over time
- “Your longest: 21 days (Day 15-35)”
Important Design Notes:
- No global leaderboard (avoids toxicity)
- Friends-only keeps it intimate and supportive
- Rankings update daily, not real-time
- No penalties for missing days
4. Encouragement System
Nudges (Passive Notifications)
Friend Activity Nudges:
- “Sarah is on a 5-day streak! 🔥”
- “3 friends completed today’s meditation”
- “Mike just started his journey—welcome them!”
- “Alex reached Day 20. They’re two-thirds through!”
Milestone Nudges:
- “Sarah completed Week 1! 🎉”
- “Mike hit a 14-day streak!”
- “Alex reached Day 40 and is now a Guide! 🌟”
Group Activity Nudges:
- “5 friends meditated today”
- “Your cohort is 80% through the journey”
- “3 friends reached Day 30 this week”
Nudge Settings:
- Frequency: Real-time / Daily digest / Weekly / Off
- Types: All / Milestones only / None
- Delivery: In-app / Push notification / Both
Celebrations
Individual Celebrations:
- Friend completes a week: “Sarah completed Week 2! 🎉”
- Friend hits streak milestone: “Mike’s 21-day streak! Incredible! 🔥”
- Friend reaches Day 40: “Alex completed the journey! They’re now a Guide! 🌟”
Group Celebrations:
- Multiple friends at same milestone: “You, Sarah, and Mike all reached Day 20!”
- Cohort progress: “Your March cohort is 75% complete!”
- Streak synchronization: “You and 2 friends all have 7-day streaks!”
Celebration Display:
┌─────────────────────────────────────┐
│ 🎉 Celebration! │
│ │
│ Sarah completed Day 40! │
│ │
│ They've reached the convergence. │
│ Now they're a Guide for others. │
│ │
│ [Send Congratulations] │
└─────────────────────────────────────┘
Support Messages
Pre-written Encouragement Options:
For streak milestones:
- “Amazing streak! Your dedication inspires me. 🔥”
- “XX days strong! Keep that momentum going.”
- “Consistency is key—you’re proving it!”
For day progress:
- “Day XX complete! You’re making real progress.”
- “The middle is the hardest—you’re doing great.”
- “Almost there! The final stretch is powerful.”
For new starters:
- “Welcome to the journey! You’re going to love it.”
- “Day 1 is the most important day. Well done!”
- “So glad you started. I’m here if you need support.”
For tough days:
- “Day 20 is intense—you’ve got this.”
- “The Mirror Stage is challenging. Trust the process.”
- “Every day matters, including the hard ones.”
For completion:
- “Day 40! You did it! 🌟”
- “Welcome to the Guides. Your journey inspires.”
- “What a transformation. Congratulations!”
Generic support:
- “Thinking of you on your journey.”
- “Your practice inspires my practice.”
- “Here if you need encouragement.”
Custom Message Option:
- Users can write custom messages (max 140 characters)
- Profanity filter applied
- No links allowed (prevent spam)
- Messages are one-way (no conversation threads)
Sending Encouragement:
┌─────────────────────────────────────┐
│ Send Encouragement to Sarah │
│ │
│ [Quick Options] │
│ ○ "Amazing streak! 🔥" │
│ ○ "Day 25—almost there!" │
│ ○ "Your journey inspires me." │
│ ○ "Custom message..." │
│ │
│ [Send] [Cancel] │
└─────────────────────────────────────┘
5. Group Journeys
Start Together
Creating a Group:
- User selects “Start Group Journey”
- Chooses start date (today or future)
- Names the group (optional): “Team Alpha” / “March Mindfulness”
- System generates invite link
- User shares with friends
- Friends join before start date
- Everyone begins Day 1 together on start date
Group Dashboard:
┌─────────────────────────────────────┐
│ Team Alpha │
│ Started: March 1, 2024 │
│ │
│ Group Progress: Day 15 of 40 │
│ █████████████████████░░░░░░░░░░░░ │
│ │
│ Members (5): │
│ 🟢 You ............... Day 15 │
│ 🟢 Sarah ............. Day 15 │
│ 🟢 Mike .............. Day 15 │
│ 🟡 Alex .............. Day 14 │
│ 🔴 Jamie ............. Day 12 │
│ │
│ [View Journey Map] [Send Group Msg]│
└─────────────────────────────────────┘
Group Features:
- Synchronized start (everyone on same day)
- Group progress visualization
- Member status indicators (on track / 1 day behind / 2+ days behind)
- Group encouragement (send to all members)
- Group celebration when everyone hits milestones
Group Management:
- Creator can remove members
- Members can leave anytime
- Group dissolves after Day 40 + 30 days
- Data deleted when group dissolves
Cohort Mode
Public Cohorts:
- Pre-scheduled start dates (1st of each month)
- Open to anyone who opts in
- “March 2024 Cohort” / “April 2024 Cohort”
- Anonymous participation option
Cohort Dashboard:
┌─────────────────────────────────────┐
│ March 2024 Cohort │
│ 247 members • Day 15 of 40 │
│ │
│ Today's Completion: 89% │
│ ████████████████████████████░░░ │
│ │
│ Cohort Progress: │
│ Day 15: 156 members (63%) │
│ Day 14: 48 members (19%) │
│ Day 13: 23 members (9%) │
│ Other: 20 members (9%) │
│ │
│ You're in the majority—well done! │
└─────────────────────────────────────┘
Cohort Benefits:
- Shared experience with strangers-turned-journey-mates
- Anonymous participation removes social pressure
- See you’re not alone in the practice
- Collective energy of synchronized practice
Cohort Privacy:
- Members see aggregate data only
- No individual identification (unless friends)
- Can participate fully anonymously
- Can switch to private mode anytime
Technical Implementation
Data Model
Friend Connection
{
// Unique identifiers
connectionId: "uuid-v4", // Primary key
userId: "uuid-v4", // User who initiated
friendId: "uuid-v4", // User who accepted
// Connection status
status: "pending" | "accepted" | "blocked" | "removed",
initiatedAt: "ISO-8601 timestamp",
acceptedAt: "ISO-8601 timestamp", // null if pending
// Permissions (granular privacy)
permissions: {
seeProgress: boolean, // default: true
seeStreaks: boolean, // default: true
seeName: boolean, // default: true
sendEncouragement: boolean, // default: true
seeLastActive: boolean // default: true
},
// Metadata
source: "invite_link" | "qr_code" | "manual_code",
inviteCode: "ABC123XYZ", // For tracking
// Soft delete
removedAt: "ISO-8601 timestamp", // null if active
removedBy: "uuid-v4" // Who removed the connection
}Shared Progress
{
// User identification
userId: "uuid-v4",
// Display information (user-controlled)
displayName: "Sarah" | "Meditator #1234" | null,
avatar: "🧘" | "🌸" | "🌙" | "custom_url" | null,
// Progress data
currentDay: 23, // 1-40, or 0 if not started
totalCompleted: 22, // Total days completed
currentStreak: 5, // Consecutive days
longestStreak: 12, // All-time best
// Activity tracking
lastActive: "ISO-8601 timestamp",
lastCompletedDay: "ISO-8601 timestamp",
// Journey status
journeyStatus: "not_started" | "in_progress" | "completed" | "paused",
startedAt: "ISO-8601 timestamp",
completedAt: "ISO-8601 timestamp", // null if not completed
// Privacy level
privacyLevel: "private" | "friends" | "anonymous",
// Visibility flags (granular control)
visibility: {
showProgress: boolean,
showStreaks: boolean,
showName: boolean,
showLastActive: boolean
},
// Social features enabled
socialEnabled: boolean,
socialEnabledAt: "ISO-8601 timestamp"
}Encouragement Message
{
messageId: "uuid-v4",
// Sender/recipient
senderId: "uuid-v4",
recipientId: "uuid-v4",
// Message content
messageType: "pre_written" | "custom",
preWrittenId: "streak_milestone_1", // null if custom
customText: "You're doing great!", // null if pre-written
// Timestamps
sentAt: "ISO-8601 timestamp",
readAt: "ISO-8601 timestamp", // null if unread
// Status
status: "sent" | "delivered" | "read",
// Soft delete
deletedBySender: boolean,
deletedByRecipient: boolean
}Group Journey
{
groupId: "uuid-v4",
// Group info
name: "Team Alpha",
description: "Our mindfulness journey",
createdBy: "uuid-v4",
createdAt: "ISO-8601 timestamp",
// Schedule
startDate: "ISO-8601 date",
currentDay: 15, // Calculated from start date
// Members
members: [
{
userId: "uuid-v4",
joinedAt: "ISO-8601 timestamp",
role: "creator" | "member",
status: "active" | "left" | "removed"
}
],
// Settings
isPublic: false, // Private groups only
allowNewMembers: true, // Can new people join?
maxMembers: 20, // Limit for private groups
// Status
status: "forming" | "active" | "completed" | "dissolved",
dissolvedAt: "ISO-8601 timestamp"
}Cohort
{
cohortId: "uuid-v4",
// Cohort info
name: "March 2024",
startDate: "2024-03-01",
endDate: "2024-04-09", // 40 days later
// Members (anonymous)
totalMembers: 247,
activeMembers: 189, // Completed today
// Progress distribution
progressDistribution: {
"day_40": 12,
"day_39": 8,
// ... etc
"day_1": 3,
"not_started": 5
},
// Aggregate stats
averageCompletion: 0.89, // 89% completed today
totalMeditationMinutes: 14820,
// Status
status: "forming" | "active" | "completed",
isJoinable: true // Can new people join?
}Sync Strategy
Real-Time Updates (WebSockets)
Connection:
- WebSocket connection established when app opens
- Authenticated with JWT token
- Reconnects automatically on disconnect
Events:
// Client → Server
{
type: "subscribe_friends",
friendIds: ["uuid-1", "uuid-2", "uuid-3"]
}
// Server → Client
{
type: "friend_progress_update",
friendId: "uuid-1",
data: {
currentDay: 24,
currentStreak: 6,
lastActive: "2024-03-15T09:30:00Z"
},
timestamp: "2024-03-15T09:30:15Z"
}Event Types:
friend_progress_update: Friend completed a dayfriend_streak_milestone: Friend hit streak milestonefriend_journey_complete: Friend finished Day 40encouragement_received: New encouragement messagefriend_connected: New friend connection acceptedgroup_update: Group member progress update
Polling Fallback
When WebSockets Unavailable:
- Poll every 5 minutes when app is open
- Poll immediately when app foregrounds
- Poll after user action (completing day, sending encouragement)
Polling Endpoint:
GET /api/social/friends/progress
Response: {
friends: [
{
friendId: "uuid-1",
currentDay: 24,
currentStreak: 6,
lastActive: "2024-03-15T09:30:00Z",
hasUpdate: true // New since last poll
}
],
lastPoll: "2024-03-15T09:00:00Z"
}Push Notifications
Notification Types:
- Friend streak milestone
- Friend journey completion
- Encouragement received
- Group milestone reached
- Cohort celebration
Delivery Strategy:
- Batch non-urgent notifications (daily digest)
- Immediate delivery for encouragement received
- Respect user’s quiet hours (no notifications 10pm-7am)
- Honor DND mode
Privacy Controls
Granular Permissions System
Permission Matrix:
| Action | Private | Friends Only | Anonymous Public |
|---|---|---|---|
| See current day | No | Yes | Yes (as “Day X”) |
| See streak | No | Yes | Yes (as “X-day streak”) |
| See name | No | Yes | No (anonymous) |
| See last active | No | Optional | No |
| Send encouragement | No | Yes | No |
Permission Change Flow:
- User changes privacy setting in UI
- Client sends update to server
- Server validates change
- Server updates
SharedProgressrecord - Server notifies affected friends (“Sarah is now sharing anonymously”)
- Friends’ apps update on next sync
Data Retention & Deletion
Friend Connection Removal:
- Connection marked as
removedin database - Both users no longer see each other’s progress
- Historical encouragement messages retained but anonymized
- Data permanently deleted after 90 days
Social Features Disable:
- User can disable all social features in one action
- All friend connections marked removed
- Shared progress data deleted
- Encouragement messages anonymized
- User can re-enable later (fresh start)
Account Deletion:
- All friend connections deleted
- All shared progress deleted
- All encouragement messages deleted
- Group memberships removed
- Cohort participation anonymized
- Full deletion within 30 days
Data Export:
- User can request export of all social data
- Includes: friend list, encouragement history, group memberships
- Delivered as JSON file
- Processed within 7 days
User Flows
Enabling Social Features
Flow Diagram:
┌─────────────────────────────────────────────────────────────┐
│ Settings → Social Features → "Enable Social Features" │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Privacy Explanation Screen] │
│ │
│ "Social features let you: │
│ • Share progress with friends │
│ • See friends' journeys │
│ • Send and receive encouragement │
│ • Join group journeys │
│ │
│ You control what you share and who can see it. │
│ You can disable this anytime." │
│ │
│ [Learn More] [Continue] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Privacy Level Selection] │
│ │
│ Who can see your progress? │
│ │
│ ○ Private - No one sees your progress │
│ ○ Friends Only - Only friends you connect with │
│ ● Anonymous Public - Progress visible, identity hidden │
│ │
│ [Advanced Privacy Settings] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Advanced Privacy Settings] │
│ │
│ Who can see your: │
│ [•] Current day in journey │
│ [•] Streak count │
│ [ ] Last active time │
│ │
│ Who can send you encouragement: │
│ [•] Friends only │
│ [ ] No one │
│ │
│ Display name: │
│ [Sarah] (or leave blank for anonymous) │
│ │
│ Avatar: [🧘] [🌸] [🌙] [🕉️] [Custom] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Confirmation Screen] │
│ │
│ You're about to enable social features with: │
│ • Privacy: Friends Only │
│ • Share: Day progress, streaks │
│ • Receive encouragement: Yes │
│ │
│ You can change these settings anytime. │
│ │
│ [Enable Social Features] [Go Back] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Success Screen] │
│ │
│ 🎉 Social features enabled! │
│ │
│ Next steps: │
│ • Add friends to see their progress │
│ • Join a group journey │
│ • Share your progress │
│ │
│ [Add Friends] [Join Group] [Done] │
└─────────────────────────────────────────────────────────────┘
Adding a Friend
Flow Diagram:
┌─────────────────────────────────────────────────────────────┐
│ Social → Friends → "Add Friend" │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Add Friend Options] │
│ │
│ Choose how to connect: │
│ │
│ [📤 Share Invite Link] │
│ [📷 Scan QR Code] │
│ [⌨️ Enter Friend Code] │
└─────────────────────────────────────────────────────────────┘
// Option 1: Share Invite Link
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Your Invite Link] │
│ │
│ convergence://join/ABC123XYZ │
│ │
│ [Share] [Copy] [QR Code] │
│ │
│ Share via: [Twitter] [WhatsApp] [Email] [More] │
└─────────────────────────────────────────────────────────────┘
│
▼
[User shares link]
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Friend Receives Link] │
│ │
│ "Join me on The Convergence Protocol! │
│ 40 days of meditation and self-discovery." │
│ │
│ [Open in App] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Connection Request Screen] │
│ │
│ Sarah wants to connect │
│ │
│ If you accept, you'll be able to: │
│ • See each other's progress │
│ • Send encouragement │
│ • Journey together │
│ │
│ [Accept] [Decline] [Block] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Success - Both Sides] │
│ │
│ You're now connected with Sarah! │
│ │
│ [View Their Progress] [Send Encouragement] │
└─────────────────────────────────────────────────────────────┘
Sharing Progress
Flow Diagram:
┌─────────────────────────────────────────────────────────────┐
│ [After Completing Day 23] │
│ │
│ ✓ Day 23 Complete │
│ │
│ "The obstacle is the path." │
│ │
│ [Continue] [Share Progress] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Share Options] │
│ │
│ Share your progress: │
│ │
│ [📱 Share Card Preview] │
│ │
│ Share to: │
│ [Twitter] [Facebook] [LinkedIn] [Instagram] │
│ [WhatsApp] [Telegram] [Email] │
│ │
│ [💾 Download Image] [🔗 Copy Link] │
│ │
│ [☐ Don't ask again today] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Twitter Share Preview] │
│ │
│ [Share Card Image] │
│ │
│ Caption: │
│ Day 23 of 40 in The Convergence Protocol 🧘 │
│ │
│ "The obstacle is the path." │
│ │
│ 12-day streak going strong. │
│ │
│ #ConvergenceProtocol #MeditationJourney │
│ │
│ [Edit] [Share to Twitter] [Cancel] │
└─────────────────────────────────────────────────────────────┘
Sending Encouragement
Flow Diagram:
┌─────────────────────────────────────────────────────────────┐
│ [Friend List → Tap Sarah] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Sarah's Progress Card] │
│ │
│ 🧘 Sarah Chen │
│ │
│ Day 25 of 40 ████████████████░░░░░░░ │
│ 🔥 14-day streak │
│ Last active: Today │
│ │
│ [Send Encouragement] [View Journey] [Remove Friend] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Send Encouragement] │
│ │
│ Send to Sarah: │
│ │
│ Quick options: │
│ ○ "Amazing streak! 🔥" │
│ ○ "Day 25—almost there!" │
│ ○ "Your journey inspires me." │
│ ○ "Day 20 is tough—you've got this" │
│ ● "Custom message..." │
│ │
│ [Write your own (140 chars max)] │
│ "So impressed by your consistency!" │
│ │
│ [Send] [Cancel] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Success] │
│ │
│ ✓ Encouragement sent to Sarah! │
│ │
│ [Back to Friends] │
└─────────────────────────────────────────────────────────────┘
Creating a Group Journey
Flow Diagram:
┌─────────────────────────────────────────────────────────────┐
│ Social → Groups → "Create Group" │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Create Group Journey] │
│ │
│ Group name (optional): │
│ [Team Alpha ] │
│ │
│ Start date: │
│ [Today] [Tomorrow] [Custom: ___] │
│ │
│ [•] Everyone starts Day 1 together │
│ [ ] Members can join anytime (not recommended) │
│ │
│ [Create Group] │
└─────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────┐
│ [Group Created!] │
│ │
│ Team Alpha starts March 15, 2024 │
│ │
│ Invite friends: │
│ [Share Invite Link] │
│ [Invite from Friends List] │
│ │
│ Group code: ALPHA88 │
│ │
│ [Done] │
└─────────────────────────────────────────────────────────────┘
Safety & Moderation
Anti-Spam Measures
Rate Limiting:
- Friend requests: Max 10 per day per user
- Encouragement messages: Max 50 per day per user
- Custom messages: Max 20 per day per user
- Group invites: Max 5 per day per user
Block Functionality:
- Users can block any friend
- Blocked users cannot:
- See your progress
- Send encouragement
- Invite you to groups
- Find you via search
- Block is one-way (you also don’t see them)
- Can unblock anytime
Report System:
- Report categories:
- Inappropriate message
- Harassment
- Spam
- Other
- Reports reviewed within 24 hours
- Action taken: Warning / Temporary ban / Permanent ban
- Reporter notified of outcome
No Public Messaging:
- Only pre-written encouragement options
- Custom messages limited to 140 characters
- No links allowed in custom messages
- No conversation threads (one-way only)
- No group chat functionality
Mental Health Safeguards
No “Falling Behind” Messaging:
- Never show “You’re behind Sarah”
- Never show “X friends are ahead of you”
- Frame all comparisons positively
- Emphasize personal journey over relative progress
No Guilt for Missed Days:
- Streak resets without shame
- “Your streak ended. Day 1 is always available.”
- Celebrate return: “Welcome back! Your journey continues.”
- No notifications about broken streaks
Emphasis on Personal Journey:
- Default view: Your progress only
- Social features are opt-in
- Easy to disable if causing anxiety
- Regular check-ins: “How are you feeling about social features?”
Resources for Overwhelm:
- In-app message: “Feeling overwhelmed? It’s okay to take a break.”
- Link to mental health resources
- Option to pause (not quit) the journey
- Option to disable social features temporarily
Design Principles:
- No red colors for “bad” states (use neutral grays)
- No negative sound effects
- No vibration for “failure” events
- Positive framing on all copy
Content Moderation
Pre-written Messages:
- All pre-written options reviewed by mental health professionals
- No comparative language (“better than”, “ahead of”)
- No pressure language (“should”, “need to”)
- Focus on celebration and support
Custom Message Filtering:
- Profanity filter (block inappropriate language)
- Link detection (block URLs)
- Contact info detection (block phone numbers, emails)
- Pattern detection for spam
- AI moderation for harmful content
User Controls:
- Disable custom messages (pre-written only)
- Disable all encouragement
- Block specific users
- Report inappropriate content
Metrics & Success
Engagement Metrics
Social Feature Adoption:
- Percentage of users who enable social features
- Breakdown by privacy level chosen
- Time to enable (days after starting journey)
- Correlation with journey completion
Friend Connections:
- Average number of friends per social user
- Connection acceptance rate
- Average time from invite to acceptance
- Most common connection method
Sharing Activity:
- Shares per user per week
- Most popular share destination
- Share card generation rate
- Organic signups from share links
Encouragement Activity:
- Encouragement messages sent per user
- Pre-written vs custom message ratio
- Most popular pre-written options
- Encouragement response rate
Group Participation:
- Percentage of social users in groups
- Average group size
- Group completion rate vs solo completion rate
- Cohort participation rate
Success Indicators
Primary Success Metrics:
-
Higher Completion Rates for Social Users
- Target: Social users 20% more likely to complete Day 40
- Track: Day 40 completion rate (social vs non-social)
- Segment: By number of friends, by group participation
-
Longer Streaks with Friends
- Target: Social users have 30% longer average streaks
- Track: Average streak length (social vs non-social)
- Segment: By friend count, by encouragement received
-
Positive Sentiment in Feedback
- Target: 80% positive sentiment on social features
- Track: In-app feedback, app store reviews, support tickets
- Monitor: Specific complaints about social features
-
Organic Growth from Shares
- Target: 15% of new users from share links
- Track: Attribution of new signups
- Monitor: Share-to-signup conversion rate
Secondary Success Metrics:
-
Engagement Depth
- Daily active social users / Total social users
- Average session frequency for social users
- Feature usage breadth (how many features used)
-
Community Health
- Friend retention rate (still connected after 30 days)
- Block rate (low is good)
- Report rate (low is good)
- Encouragement sentiment analysis
-
Privacy Respect
- Percentage keeping privacy as “Private” or “Friends Only”
- Rate of privacy setting changes
- Social feature disable rate
- Account deletion rate
Success Dashboard:
┌─────────────────────────────────────────────────────────────┐
│ Social Features Success Dashboard │
│ Last 30 Days │
├─────────────────────────────────────────────────────────────┤
│ │
│ ADOPTION │
│ Social feature enable rate: 42% ████████████░░░░░░░░░ │
│ Target: 50% │
│ │
│ COMPLETION │
│ Day 40 completion (social): 68% ██████████████████░░░ │
│ Day 40 completion (non-social): 52% ██████████████░░░ │
│ Lift: +31% ✓ │
│ │
│ ENGAGEMENT │
│ Avg friends per user: 3.2 │
│ Avg shares per user: 2.8 │
│ Avg encouragement sent: 12.4 │
│ │
│ GROWTH │
│ New users from shares: 18% ████████████████░░░░░░░░░░ │
│ Target: 15% ✓ │
│ │
│ HEALTH │
│ Block rate: 0.3% ✓ │
│ Report rate: 0.1% ✓ │
│ Social disable rate: 8% ✓ │
│ │
└─────────────────────────────────────────────────────────────┘
A/B Testing Opportunities
Testable Hypotheses:
-
Share Card Design
- Test: Minimal vs detailed share cards
- Metric: Share rate, click-through rate
-
Encouragement Timing
- Test: Immediate vs batched encouragement notifications
- Metric: Encouragement response rate, user satisfaction
-
Comparison Framing
- Test: “You’re ahead” vs “Your friend is at…” vs no comparison
- Metric: Engagement, completion rate, anxiety indicators
-
Group Size
- Test: Small groups (3-5) vs medium (6-10) vs large (11-20)
- Metric: Group completion rate, member satisfaction
-
Privacy Defaults
- Test: Default to “Friends Only” vs “Private”
- Metric: Adoption rate, retention rate, satisfaction
Implementation Checklist
Phase 1: Core Social (MVP)
- Share progress cards
- Basic friend connections (invite link)
- Friend progress viewing
- Pre-written encouragement
- Privacy settings (Private / Friends Only)
Phase 2: Enhanced Social
- QR code friend connections
- Journey map visualization
- Custom encouragement messages
- Streak leaderboard (friends only)
- Anonymous public mode
Phase 3: Group Features
- Private group creation
- Group progress dashboard
- Cohort mode
- Group celebrations
Phase 4: Advanced Features
- Real-time sync (WebSockets)
- Push notifications
- Advanced privacy controls
- Data export
Appendix: Copy Guidelines
Tone Principles
DO:
- Use warm, supportive language
- Celebrate effort and consistency
- Frame everything positively
- Respect individual journey
- Use inclusive language
DON’T:
- Use competitive language (“win”, “beat”, “ahead”)
- Use shame or guilt
- Create pressure or urgency
- Compare in ways that could cause anxiety
- Use addictive/gamification language (“addicted”, “can’t stop”)
Example Copy Review
| ❌ Don’t Use | ✅ Use Instead |
|---|---|
| ”You’re falling behind" | "Everyone moves at their own pace" |
| "Sarah is ahead of you" | "Sarah is on Day 25—impressive dedication!" |
| "Don’t break your streak!" | "Your 12-day streak is amazing" |
| "You should meditate today" | "Day 23 is ready when you are" |
| "Catch up to your friends" | "Your friends are cheering you on" |
| "Only 17 days left" | "You’re more than halfway through" |
| "You’re losing to Mike" | "Mike just hit Day 30—what a milestone!” |
Document Version: 1.0 Last Updated: 2024 The Convergence Protocol - Social Features Specification