{"id":50737711,"url":"https://github.com/ali-haggag7/flurry-super-app","last_synced_at":"2026-06-10T15:02:07.566Z","repository":{"id":337226837,"uuid":"1089620301","full_name":"Ali-Haggag7/Flurry-Super-App","owner":"Ali-Haggag7","description":"🚀 A comprehensive Social Super App merging Real-time Communication (Socket.io \u0026 WebRTC) with AI features (Google Gemini). Built with MERN Stack \u0026 PWA.","archived":false,"fork":false,"pushed_at":"2026-02-19T03:42:08.000Z","size":2935,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-19T08:49:03.742Z","etag":null,"topics":["fullstack","google-gemini-api","mern-stack","mongodb","nodejs","pwa","react","realtime","socket-io","webrtc"],"latest_commit_sha":null,"homepage":"https://flurry-app.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ali-Haggag7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-04T15:32:38.000Z","updated_at":"2026-02-19T03:42:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Ali-Haggag7/Flurry-Super-App","commit_stats":null,"previous_names":["ali-haggag7/flurry-app","ali-haggag7/flurry-super-app"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Ali-Haggag7/Flurry-Super-App","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ali-Haggag7%2FFlurry-Super-App","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ali-Haggag7%2FFlurry-Super-App/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ali-Haggag7%2FFlurry-Super-App/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ali-Haggag7%2FFlurry-Super-App/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ali-Haggag7","download_url":"https://codeload.github.com/Ali-Haggag7/Flurry-Super-App/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ali-Haggag7%2FFlurry-Super-App/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34157453,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fullstack","google-gemini-api","mern-stack","mongodb","nodejs","pwa","react","realtime","socket-io","webrtc"],"created_at":"2026-06-10T15:02:06.320Z","updated_at":"2026-06-10T15:02:07.548Z","avatar_url":"https://github.com/Ali-Haggag7.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌪️ Flurry - Real-time Social Media Platform\n\n\u003e **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.\n\n[![Flurry Demo Watch Video](image.png)](https://flurry-app.vercel.app/)\n\n## 🚀 Live Demo\n[Click here to visit Flurry](https://flurry-app.vercel.app/)\n\n---\n\n## ✨ Key Features (v2.0 Update)\n\n### 1️⃣ Audio \u0026 Video Calling 📹 🆕\n- **Peer-to-Peer Communication:** Crystal clear voice and video calls powered by **WebRTC**.\n- **Integrated Interface:** Seamless calling experience directly within the chat UI without third-party plugins.\n- **Connection Handling:** Smart handling of user availability and connection states.\n\n### 2️⃣ Intelligent Group Chats 🤖 🆕\n- **AI-Powered Summaries:** Integrated **Google Gemini AI** to summarize long group conversations instantly with a single click.\n- **Interactive Polls:** Create real-time voting polls within groups to make decisions faster.\n- **Admin Controls:** Full control over members (remove/add) and system event logging.\n\n### 3️⃣ Enhanced Messaging Experience 💬 🆕\n- **CRUD Operations:** Ability to **Edit** and **Delete** messages in real-time for everyone.\n- **Rich Media \u0026 Voice Notes:** Send images, videos, and record voice notes with live previews.\n- **Infinite Scrolling:** Optimized message loading (pagination) for high performance in long chats.\n- **Message States:** Detailed status tracking (Pending 🕒 -\u003e Sent ✔️ -\u003e Delivered ✔️✔️ -\u003e Read ✅).\n\n### 4️⃣ Progressive Web App (PWA) \u0026 Offline Support 📶 🆕\n- **Offline First:** The app remains functional without internet access, serving cached content via **Service Workers**.\n- **Smart Sync:** Actions performed offline (like sending messages) are queued and synced automatically when connectivity returns.\n- **Push Notifications:** Custom system-wide pop-up notifications for messages and interactions even when the app is in the background.\n\n### 5️⃣ Localization \u0026 Accessibility 🌍 🆕\n- **Multi-language Support:** Fully localized interface with instant switching between **English (LTR)** and **Arabic (RTL)**.\n- **Dynamic Layout:** The UI automatically adapts direction (RTL/LTR) based on the selected language.\n\n---\n\n## 💎 Core Features\n\n### 6️⃣ Advanced Social Feed\n- **Full Interactions:** Create, edit, delete, save, and share posts.\n- **Threaded Comments:** Infinite nested replies with independent like counters.\n- **Auto-Moderation:** Smart system that \"soft bans\" posts after receiving 5+ reports.\n- **Visual Integration:** User stories appear as a status ring around profile pictures in the feed.\n\n### 7️⃣ Real-time Chat (Socket.io)\n- **Instant Messaging:** Zero-latency chat with live typing indicators.\n- **Media Sharing:** Send images, videos, voice notes, and external links smoothly.\n- **Group Management:** Create groups and manage participants easily.\n\n### 8️⃣ Interactive Stories\n- **Rich Content:** Support for images, videos, and text with backgrounds.\n- **Smart Views:** Segmented status rings indicate viewed/unviewed stories.\n- **Direct Replies:** Reply to stories directly into the chat with a quoted reference.\n\n### 9️⃣ Privacy \u0026 Security\n- **Hard Block System:** Complete isolation between blocked users.\n- **Private Accounts:** Content is hidden from non-followers.\n- **Active Status Control:** Option to hide \"Online\" presence.\n- **Secure Auth:** Powered by **Clerk** for robust session management.\n\n### 🔟 Performance \u0026 Architecture\n- **Optimized Rendering:** Utilizing `React.memo` and `useCallback` to prevent unnecessary re-renders.\n- **Lazy Loading:** Heavy components (like Emoji Picker) load only when needed.\n- **Optimistic UI:** Instant feedback on likes/comments before server response.\n- **Rate Limiting:** Backend protection against spam and DDoS attacks.\n\n---\n\n## 🛠️ Tech Stack\n\n| Domain | Technologies |\n| :--- | :--- |\n| **Frontend** | React.js, Tailwind CSS, Framer Motion, Lucide React, **i18next** |\n| **Backend** | Node.js, Express.js, Socket.io |\n| **Real-time \u0026 AI** | **WebRTC (SimplePeer)**, **Google Gemini API** |\n| **Database** | MongoDB, Mongoose |\n| **Auth** | Clerk |\n| **Media \u0026 PWA** | ImageKit CDN, **Workbox (Service Workers)** |\n\n---\n\n## 💻 Running Locally\n\n1. **Clone the repository**\n   ```bash\n   git clone [https://github.com/Ali-Haggag7/flurry-app.git](https://github.com/Ali-Haggag7/flurry-app.git)\n   cd flurry-app\n\n2. **Install Dependencies**\n```bash\n# Install server dependencies\n    cd server\n    npm install\n\n# Return to root then install client dependencies\n    cd ../client\n    npm install\n\n```\n3. **Environment Variables Create a .env file in both client and server directories and add your keys (Clerk, MongoDB, ImageKit).**\n\n4. **Run the App**\n\n```bash\n# Run Backend (Open new terminal)\ncd server\nnpm start\n\n```\n```bash\n# Run Frontend (Open separate terminal)\ncd client\nnpm run dev\n\n```\n\n---\n\n## 📄 License\nThis project is open source and available under the [MIT License](LICENSE). \nCreated by **Ali Haggag**. © 2026 All rights reserved.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fali-haggag7%2Fflurry-super-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fali-haggag7%2Fflurry-super-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fali-haggag7%2Fflurry-super-app/lists"}