https://github.com/ali-haggag7/flurry-super-app

🚀 A comprehensive Social Super App merging Real-time Communication (Socket.io & WebRTC) with AI features (Google Gemini). Built with MERN Stack & PWA.
https://github.com/ali-haggag7/flurry-super-app

fullstack google-gemini-api mern-stack mongodb nodejs pwa react realtime socket-io webrtc

Last synced: 8 days ago
JSON representation

🚀 A comprehensive Social Super App merging Real-time Communication (Socket.io & WebRTC) with AI features (Google Gemini). Built with MERN Stack & PWA.

Host: GitHub
URL: https://github.com/ali-haggag7/flurry-super-app
Owner: Ali-Haggag7
Created: 2025-11-04T15:32:38.000Z (8 months ago)
Default Branch: main
Last Pushed: 2026-02-19T03:42:08.000Z (4 months ago)
Last Synced: 2026-02-19T08:49:03.742Z (4 months ago)
Topics: fullstack, google-gemini-api, mern-stack, mongodb, nodejs, pwa, react, realtime, socket-io, webrtc
Language: JavaScript
Homepage: https://flurry-app.vercel.app
Size: 2.8 MB
Stars: 1
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# 🌪️ Flurry - Real-time Social Media Platform

> **Flurry** is a fully functional, mobile-first social media application built with the MERN stack. It bridges the gap between traditional social feeds and instant messaging, offering a seamless, app-like experience on the web.

[![Flurry Demo Watch Video](image.png)](https://flurry-app.vercel.app/)

## 🚀 Live Demo
[Click here to visit Flurry](https://flurry-app.vercel.app/)

---

## ✨ Key Features (v2.0 Update)

### 1️⃣ Audio & Video Calling 📹 🆕
- **Peer-to-Peer Communication:** Crystal clear voice and video calls powered by **WebRTC**.
- **Integrated Interface:** Seamless calling experience directly within the chat UI without third-party plugins.
- **Connection Handling:** Smart handling of user availability and connection states.

### 2️⃣ Intelligent Group Chats 🤖 🆕
- **AI-Powered Summaries:** Integrated **Google Gemini AI** to summarize long group conversations instantly with a single click.
- **Interactive Polls:** Create real-time voting polls within groups to make decisions faster.
- **Admin Controls:** Full control over members (remove/add) and system event logging.

### 3️⃣ Enhanced Messaging Experience 💬 🆕
- **CRUD Operations:** Ability to **Edit** and **Delete** messages in real-time for everyone.
- **Rich Media & Voice Notes:** Send images, videos, and record voice notes with live previews.
- **Infinite Scrolling:** Optimized message loading (pagination) for high performance in long chats.
- **Message States:** Detailed status tracking (Pending 🕒 -> Sent ✔️ -> Delivered ✔️✔️ -> Read ✅).

### 4️⃣ Progressive Web App (PWA) & Offline Support 📶 🆕
- **Offline First:** The app remains functional without internet access, serving cached content via **Service Workers**.
- **Smart Sync:** Actions performed offline (like sending messages) are queued and synced automatically when connectivity returns.
- **Push Notifications:** Custom system-wide pop-up notifications for messages and interactions even when the app is in the background.

### 5️⃣ Localization & Accessibility 🌍 🆕
- **Multi-language Support:** Fully localized interface with instant switching between **English (LTR)** and **Arabic (RTL)**.
- **Dynamic Layout:** The UI automatically adapts direction (RTL/LTR) based on the selected language.

---

## 💎 Core Features

### 6️⃣ Advanced Social Feed
- **Full Interactions:** Create, edit, delete, save, and share posts.
- **Threaded Comments:** Infinite nested replies with independent like counters.
- **Auto-Moderation:** Smart system that "soft bans" posts after receiving 5+ reports.
- **Visual Integration:** User stories appear as a status ring around profile pictures in the feed.

### 7️⃣ Real-time Chat (Socket.io)
- **Instant Messaging:** Zero-latency chat with live typing indicators.
- **Media Sharing:** Send images, videos, voice notes, and external links smoothly.
- **Group Management:** Create groups and manage participants easily.

### 8️⃣ Interactive Stories
- **Rich Content:** Support for images, videos, and text with backgrounds.
- **Smart Views:** Segmented status rings indicate viewed/unviewed stories.
- **Direct Replies:** Reply to stories directly into the chat with a quoted reference.

### 9️⃣ Privacy & Security
- **Hard Block System:** Complete isolation between blocked users.
- **Private Accounts:** Content is hidden from non-followers.
- **Active Status Control:** Option to hide "Online" presence.
- **Secure Auth:** Powered by **Clerk** for robust session management.

### 🔟 Performance & Architecture
- **Optimized Rendering:** Utilizing `React.memo` and `useCallback` to prevent unnecessary re-renders.
- **Lazy Loading:** Heavy components (like Emoji Picker) load only when needed.
- **Optimistic UI:** Instant feedback on likes/comments before server response.
- **Rate Limiting:** Backend protection against spam and DDoS attacks.

---

## 🛠️ Tech Stack

---

## 💻 Running Locally

1. **Clone the repository**
```bash
git clone [https://github.com/Ali-Haggag7/flurry-app.git](https://github.com/Ali-Haggag7/flurry-app.git)
cd flurry-app

2. **Install Dependencies**
```bash
# Install server dependencies
cd server
npm install

# Return to root then install client dependencies
cd ../client
npm install

```
3. **Environment Variables Create a .env file in both client and server directories and add your keys (Clerk, MongoDB, ImageKit).**

4. **Run the App**

```bash
# Run Backend (Open new terminal)
cd server
npm start

```
```bash
# Run Frontend (Open separate terminal)
cd client
npm run dev

```

---

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/ali-haggag7/flurry-super-app

Awesome Lists containing this project

README