mezonai/mezon — Gitpedia

<div align="center"> <h1>Mezon</h1> <p align="center"> <strong>The Live, Work, and Play Platform – the best Discord alternative.</strong> </p> <p align="center"> <a href="https://github.com/mezonai/mezon/releases"><img src="https://img.shields.io/github/v/release/mezonai/mezon?style=flat-square" alt="Latest Release"></a> <a href="https://github.com/mezonai/mezon/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mezonai/mezon?style=flat-square" alt="License"></a> <a href="https://github.com/mezonai/mezon/stargazers"><img src="https://img.shields.io/github/stars/mezonai/mezon?style=flat-square" alt="GitHub Stars"></a> <a href="https://github.com/mezonai/mezon/issues"><img src="https://img.shields.io/github/issues/mezonai/mezon?style=flat-square" alt="Issues"></a> <a href="https://github.com/mezonai/mezon/network/members"><img src="https://img.shields.io/github/forks/mezonai/mezon?style=flat-square" alt="Forks"></a> </p> <p align="center"> <a href="https://mezon.ai"><img src="https://img.shields.io/badge/Try%20Live-mezon.ai-blue?style=flat-square" alt="Try Live"></a> <a href="https://mezon.ai/invite/1840696977034055680"><img src="https://img.shields.io/badge/Join-Community-purple?style=flat-square" alt="Join Community"></a> <a href="#contributing"><img src="https://img.shields.io/badge/Contributions-Welcome-green?style=flat-square" alt="Contributions Welcome"></a> </p> </div>

Mezon Bug Report Community

The Live, Work, and Play Platform the best Discord Alternative

Mezon is a Live, Work, and Play platform. It’s perfect for gaming and chilling with friends, or even building a global community. Customize your own space to talk, play, and hang out. Mezon also delivers enterprise-grade performance with sub-millisecond response times and support for millions of concurrent connections.

✨ Key Features

🔒 Security First - End-to-end encryption, XSS protection, zero-knowledge architecture
⚡ High Performance - Sub-millisecond response times, millions of concurrent connections
🌐 Cross-Platform - Web, Desktop (Windows/macOS/Linux), Mobile (iOS/Android)
🤖 AI-Powered - Built-in content moderation, real-time translation, meeting summaries
🔧 Extensible - Custom bots, 100+ integrations, API-first design
💰 Creator Economy - Built-in monetization, premium memberships, token rewards

🎯 Use Cases

Use Case	Features
Gaming Communities	Voice chat, tournaments, streaming integration
Professional Teams	Channels, file sharing, integrations, meeting tools
Content Creators	Monetization tools, community building, analytics
Personal Groups	Private spaces, family connections, secure messaging

🚀 Quick Start

For Users

Web App: Visit mezon.ai - no installation required
Desktop: Download from releases for Windows, macOS, or Linux
Mobile: Get the app from App Store or Google Play

For Developers

bash
# Clone the repository
git clone https://github.com/mezonai/mezon.git
cd mezon

# Install dependencies
yarn install

# Start development server
yarn dev:chat

The application will be available at http://localhost:4200/

📖 Need help? Check out our Developer Guide for detailed setup instructions.

🌟 Core Features

💬 Communication

Rich Text Messaging - Markdown support, threads, reactions, file sharing up to 500MB
Voice & Video - Crystal-clear HD calls supporting up to 1000 users
Screen Sharing - Built-in recording and streaming capabilities

🛡️ Security & Privacy

End-to-End Encryption - All messages, voice, and video communications
Zero-Knowledge Architecture - Client-side encryption, secure binary sockets
XSS Protection - Safe message rendering and content validation

🎯 Organization & Management

Advanced Permissions - Custom roles with granular permission controls
Smart Notifications - AI-powered filtering and priority management
Event Scheduling - Built-in calendar with RSVP system

🤖 AI-Powered Features

Content Moderation - Automated safety and community management
Real-time Translation - Support for 100+ languages
Meeting Intelligence - Auto-generated summaries and transcription

🔧 Integration & Extensibility

API-First Design - Comprehensive REST and WebSocket APIs
Bot Framework - Extensible platform with SDK support
Third-party Integrations - 100+ tools and custom webhooks

📦 Installation

System Requirements

Platform	Requirements
Web	Modern browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)
Desktop	Windows 10+, macOS 10.15+, Ubuntu 18.04+
Mobile	iOS 13.0+, Android 8.0+ (API level 26+)
Development	Node.js 18+, Yarn 1.22.4+, 4GB RAM minimum

Source code

Platform	Git Repo	Status
Desktop	Desktop repo	✅ Stable
iOS	IOS repo	✅ Stable
Android	Android repo	✅ Stable
Web	Web repo	✅ Stable

Download Options

Platform	Download Link	Status
Windows	Download	✅ Stable
macOS	Download	✅ Stable
Linux	Download	✅ Stable
iOS	App Store	✅ Stable
Android	Google Play	✅ Stable
Web	mezon.ai	✅ Stable

👨‍💻 Development

🛠️ Development Setup

bash
# Clone the repository
git clone https://github.com/mezonai/mezon.git
cd mezon

# Install dependencies
yarn install

# Available development commands
yarn dev:chat          # Start chat app (port 4200)
yarn dev:admin         # Start admin dashboard (port 4200)
yarn dev:mobile        # Start mobile development
yarn dev:desktop       # Start desktop app

# Build for production
yarn build:chat        # Build web chat app
yarn build:desktop     # Build desktop app
yarn build:mobile      # Build mobile apps

# Code quality
yarn lint              # Run linting
yarn format           # Format code

Local Development Setup Guide

1. Install Dependencies

Open your terminal in the project's root directory and run the following command to install the necessary packages:

bash
yarn install

2. Retrieve Authentication Data from Dev

To access protected data and features on your local machine, you need to copy your session tokens from the Development environment:

Navigate to: https://dev-mezon.nccsoft.vn
Log in with your credentials.
Open Developer Tools (Press F12 or Right-click > Inspect).
Go to the Application tab.
In the left sidebar, expand Local Storage and select https://dev-mezon.nccsoft.vn.
Locate and copy the values for the following keys:

persist:auth
mezon_session

3. Configure Localhost Storage

Once your local server is running (typically at http://localhost:4200):

Open your Localhost URL in the browser.
Open Developer Tools (F12) > Application tab > Local Storage.
Manually add or edit the keys persist:auth and mezon_session.
Paste the corresponding values you copied from the Dev site into the Value column.

4. Finalize

Refresh your local browser tab to apply the authentication state:

Press F5 or Cmd/Ctrl + R.

You should now be logged into the local environment with your Dev session active.

📁 Project Structure

mezon/
├── apps/              # Applications
│   ├── chat/          # Main web chat application
│   ├── admin/         # Admin dashboard
│   ├── desktop/       # Electron desktop app
│   ├── mobile/        # React Native mobile app
│   └── discover/      # Community discovery app
├── libs/              # Shared libraries
│   ├── components/    # Reusable UI components
│   ├── store/         # State management (Redux)
│   ├── transport/     # API & WebSocket clients
│   ├── core/          # Business logic
│   └── ui/            # Design system
└── docs/              # Documentation

🔧 Technology Stack

Frontend

Framework: React 18 with TypeScript
State Management: Redux Toolkit + RTK Query
Styling: Tailwind CSS
Build Tool: Nx Monorepo with Webpack
Mobile: React Native
Desktop: Electron

Backend & Infrastructure

Core: We built a custom server using Redis, ScyllaDB, and sockets to enable real-time communication.
Mezon Mainnet: mmn - High-performance and zero free blockchain layer 1
Real-time: WebSocket with binary protocol
Security: E2E encryption, TLS 1.3
Performance: Sub-millisecond latency, horizontal scaling

Development Tools

Testing: Jest + Cypress
Linting: ESLint + Prettier
CI/CD: GitHub Actions
Package Manager: Yarn

📚 Getting Started

Setup: Follow the Developer Guide for detailed setup instructions
Architecture: Review Architecture docs to understand the system
Contribute: Browse open issues for contribution opportunities
Community: Join our developer community for support and discussions

🔌 Extensibility

Bot Development

Build powerful bots using our official SDKs
Automate workflows and community management
Access comprehensive APIs for custom integrations

Custom Themes

Create custom themes and UI modifications
Brand customization for communities
Personalized user interfaces

API Integration

REST API and WebSocket support
Custom webhooks and third-party integrations
Extensive documentation and examples

🔗 Resources: Bot Example | SDK Documentation

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

🐛 Report Bugs: Use our issue tracker
💡 Feature Requests: Suggest new features and improvements
💻 Code Contributions: Submit pull requests for bug fixes and features
📚 Documentation: Help improve our docs and guides
🌍 Translation: Help translate Mezon to more languages

Development Process

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Make your changes and add tests
Ensure all tests pass (yarn test)
Submit a pull request

📋 Guidelines: Please read our Contributing Guide for detailed information about our development process, coding standards, and pull request guidelines.

📚 Resources & Documentation

🚀 For Users

Web App - Try Mezon instantly
Community Directory - Discover communities
Bot/App store - Mezon Top Board
User Guide - Getting started guide

🛠️ For Developers

Developer Guide - Complete setup and development guide
API Documentation - REST API and WebSocket reference
Architecture Guide - System design and architecture
Bot Development - Bot creation tutorial

📦 SDKs & Libraries

JavaScript SDK - Official JS/TS SDK
Go SDK - Official Go SDK
Java SDK - Official Java SDK
Python SDK - Official Python SDK
NestJS SDK - Official NestJs SDK
Mezon WebJs SDK - SDK for channel apps integration
MCP Integration - AI-ready integration

🌐 Community & Support

Community Hub - Join our official community
GitHub Discussions - Ask questions and share ideas
Issue Tracker - Report bugs and request features
Developer Portal - Build applications on Mezon

🔧 Troubleshooting

Common Issues

Installation Problems

Ensure Node.js 18+ and Yarn 1.22.4+ are installed
Clear node_modules and reinstall: rm -rf node_modules && yarn install
Check system requirements for your platform

Development Issues

Port conflicts: Change port in project configuration
Build failures: Run yarn lint and yarn format to fix code issues
WebSocket connection issues: Check firewall and proxy settings

Performance Issues

Enable hardware acceleration in browser settings
Close unnecessary applications to free up system resources
Update to the latest version for performance improvements

🆘 Need Help? Visit our troubleshooting guide or ask in our community chat.

📄 License & Legal

License: MIT License - Free for personal and commercial use
Privacy Policy: mezon.ai/privacy
Terms of Service: mezon.ai/terms
Security Policy: SECURITY.md

🙏 Acknowledgments

Mezon is built on top of amazing open-source technologies:

webrtc - Pion WebRTC A pure Go implementation of the WebRTC API
livekit - Livekit
ScyllaDB - ScyllaDB
Redis - Redis
imgproxy - imgproxy
minio - minio
Ory Hydra - OAuth 2.0 and OpenID Connect server
Snowflake - A very simple Twitter snowflake generator
React - UI framework
Nx - Monorepo tooling
And many other fantastic open-source projects

<div align="center"> <p> <strong>Made with ❤️ by the Mezon Team</strong><br> <em>Connecting communities worldwide</em> </p> <p> <a href="https://github.com/mezonai/mezon">⭐ Star us on GitHub</a> • <a href="https://mezon.ai/invite/1840696977034055680">💬 Join our community</a> • <a href="https://github.com/mezonai/mezon/issues/new/choose">🐛 Report an issue</a> </p> </div>