HarmonyFederated Social Platform

What is Harmony? ​

Harmony is a modern federated social platform that combines the best of Discord-style chat with ActivityPub social networking. It's designed for communities that want rich communication features while maintaining connection to the broader fediverse.

Key Features ​

🚀 Chat System ​

• Servers & Channels: Organize conversations like Discord
• Voice & Video: Built-in WebRTC calling
• Rich Media: File sharing, emojis, reactions
• Direct Messages: Private conversations

🌍 Federation ​

• ActivityPub Protocol: Full fediverse compatibility
• Cross-Platform Interaction: Follow users from Mastodon, reply to posts
• Instance Management: Run your own federated instance
• Content Discovery: Explore trending content across instances

🛠️ Technical Excellence ​

• Vue 3 + TypeScript: Modern, type-safe frontend
• Supabase Backend: Real-time database with auth
• Professional Architecture: Clean, scalable, maintainable code
• Comprehensive Documentation: Everything you need to contribute

Quick Start ​

# Clone the repository
git clone https://github.com/y4my4my4m/harmony.git

# Install dependencies
cd harmony
npm install

# Setup environment
cp .env.example .env.local
# Edit .env.local with your Supabase credentials

# Start development server
npm run dev

Architecture Overview ​

Harmony follows modern software architecture principles:

• Frontend: Vue 3 with Composition API and TypeScript
• State Management: Pinia stores with reactive patterns
• Backend: Supabase (PostgreSQL + real-time subscriptions)
• Federation: ActivityPub protocol via Node.js federation backend
• Real-time: WebSocket subscriptions and WebRTC

Community & Support ​

• Documentation: Complete guide
• API Reference: Developer docs
• GitHub: Source code & issues