🌍 Matefy - Global Language Exchange Platform

Connect • Learn • Grow Together

---

🚀 Live Demo Coming Soon | 📖 Repository

---

✨ About Matefy

Matefy is a global language exchange platform fostering real-time connections through chat and video calls. It’s built to help learners:

• Connect with native speakers 🌐
• Learn cultural nuances 🎓
• Grow international friendships 🤝

Mission: Breaking down language barriers, one conversation at a time.

---

🚀 Key Features

🔐 Authentication

• JWT-based secure login
• Profile customization with avatars
• Protected routes with middleware

👥 Friend System

• Smart recommendations and real-time notifications
• Advanced search by language, location, and interests
• Friend request management with tracking

💬 Messaging

• Instant messaging powered by Stream Chat
• Typing indicators, message reactions, and persistence

📹 Video Calling

• 1-on-1 HD video calls with professional controls
• Integrated from the chat interface

🎨 UI/UX

• 32 themes with DaisyUI
• Fully responsive design
• Dark/Light mode with smooth animations

---

🛠️ Tech Stack

Frontend

• React | Vite | TailwindCSS | DaisyUI
• State management with Zustand

Backend

• Node.js | Express | MongoDB
• JWT Authentication | Real-time integration with Stream

Architecture

📁 Frontend
├── 🎨 TailwindCSS + DaisyUI
├── 🔄 Zustand for state management
└── 📡 API management with TanStack Query

📁 Backend
├── 🔐 JWT Authentication & Authorization
├── 🗄️ MongoDB with Mongoose ODM
└── 💬 Stream Chat & Video SDK

---

⚡ Quick Start

1️⃣ Clone & Install

git clone https://github.com/its-pratyushpandey/Matefy.git
cd Matefy
npm install && cd backend && npm install && cd ../frontend && npm install

2️⃣ Environment Setup

Backend (backend/.env)

PORT=5001
MONGO_URI=mongodb://localhost:27017/matefy
JWT_SECRET_KEY=your_secret_key
STREAM_API_KEY=your_api_key
STREAM_API_SECRET=your_api_secret

Frontend (frontend/.env)

VITE_STREAM_API_KEY=your_api_key

3️⃣ Run the App

# Backend (http://localhost:5001)
cd backend && npm run dev

# Frontend (http://localhost:5173)
cd frontend && npm run dev

---

📱 Screenshots

🏠 Dashboard

💬 Real-time Chat

📹 Video Calling

👥 Friends Management

🔔 Notifications

🎨 Themes

---

🔧 Customization

Add a New Theme

1. Add it to frontend/src/constants/index.js:

export const THEMES = [..., { name: "custom-theme", colors: ["#primary", "#secondary"] }];

2. Add it in tailwind.config.js:

daisyui: { themes: ["custom-theme"] },

Add a New Language

Update frontend/src/constants/index.js:

export const LANGUAGES = [..., "New Language"];
export const LANGUAGE_TO_FLAG = { "new language": "flag-code" };

---

🧪 Testing

Run Tests

# Backend
cd backend && npm test

# Frontend
cd frontend && npm test

---

🚀 Deployment

Vercel Deployment

npm i -g vercel
vercel --prod

Railway Deployment

npm i -g @railway/cli
railway deploy

---

🛡️ Security

• JWT tokens with HTTP-only cookies
• CSRF Protection and password hashing
• Rate Limiting and CORS configuration

---

🤝 Contributing

1. Fork the repo and create a branch: git checkout -b feature/your-feature
2. Write code and tests
3. Commit changes: git commit -m 'Add feature'
4. Push and create a PR

---

📞 Support

• Email: support@matefy.app
• Discord: Join
• Issues: GitHub

---

📄 License

Matefy is licensed under the MIT License. See LICENSE.

Made with ❤️ by the Matefy Team

Breaking language barriers, one conversation at a time 🌍

⬆️ Back to Top