Skip to content

basemw0/Ma3loma

Repository files navigation

Ma3loma 🌍

A scalable, Arab-focused social community platform built with the MERN stack. Features real-time messaging, AI-powered content summarization, and a containerized backend architecture.

Live Demo

Architecture & Features

This project moves beyond basic CRUD by implementing industry-standard infrastructure patterns:

  • GenAI Integration: Leverages Google Gemini 2.5 Flash to provide one-click "Smart Summaries" for long-form discussion threads.
  • Secure Identity Management: robust authentication system using Passport.js strategies (Local + Google OAuth 2.0) with JWT session management.
  • Cloud-Native Media: Integrated Cloudinary SDK for optimized image storage and delivery (CDNs).
  • Real-Time Capabilities: Implements WebSocket-based architecture for live messaging and notifications (ChatController & Socket.io).

🛠 Tech Stack

Domain Technologies
Frontend React.js, Vite, MaterialUI, Axios
Backend Node.js, Express.js, Passport.js
Database MongoDB (Mongoose ORM)
DevOps Render (Backend), Vercel (Frontend)
Services Google Gemini API, Cloudinary API, Google OAuth

Getting Started

Prerequisites

  • Node.js (v18+)
  • MongoDB (Local or Atlas URI)

1. Clone the Repository

git clone [https://github.com/basemw0/Ma3loma.git](https://github.com/basemw0/Ma3loma.git)
cd ma3loma

🤝 Contributing

Built with ❤️ by an amazing engineering team:

About

A scalable MERN stack social platform featuring real-time messaging (Socket.io), secure OAuth2.0 authentication, and GenAI-powered content summarization using Google Gemini 2.5 Flash.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages