{"id":15180632,"url":"https://github.com/emhash/bloome","last_synced_at":"2026-03-10T05:04:14.393Z","repository":{"id":245579636,"uuid":"818668784","full_name":"emhash/Bloome","owner":"emhash","description":"Fullstack Django social media web app with newsfeed, chat, friends and so on.","archived":false,"fork":false,"pushed_at":"2024-08-22T18:48:02.000Z","size":46233,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-01T00:14:02.202Z","etag":null,"topics":["all-auth","bootstrap","chatxity","css","django","django-application","django-rest-framework","django-social-network","django-website","html","htmx","javacript","python","social-media","social-network"],"latest_commit_sha":null,"homepage":"https://bloome.pythonanywhere.com/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emhash.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-06-22T14:02:08.000Z","updated_at":"2024-08-22T18:48:06.000Z","dependencies_parsed_at":"2024-06-22T22:15:18.625Z","dependency_job_id":"9da13273-6e08-49d2-9164-2dee2455cbe3","html_url":"https://github.com/emhash/Bloome","commit_stats":{"total_commits":21,"total_committers":2,"mean_commits":10.5,"dds":"0.19047619047619047","last_synced_commit":"6180b28978bc1bd4224c99f050e9811c9eeee1f9"},"previous_names":["emhash/chatxity","emhash/bloome"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emhash%2FBloome","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emhash%2FBloome/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emhash%2FBloome/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emhash%2FBloome/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emhash","download_url":"https://codeload.github.com/emhash/Bloome/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238397179,"owners_count":19465130,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["all-auth","bootstrap","chatxity","css","django","django-application","django-rest-framework","django-social-network","django-website","html","htmx","javacript","python","social-media","social-network"],"created_at":"2024-09-27T16:23:34.654Z","updated_at":"2025-10-26T20:31:54.129Z","avatar_url":"https://github.com/emhash.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch4 align='center'\u003e\n  \n![Logo](https://github.com/user-attachments/assets/8e784d01-0977-410a-ae11-7ebc30a08061)\n\n\u003c/h4\u003e\n\n\u003ch1 align=\"center\"\u003e\n  Bloome \u0026nbsp;·\u0026nbsp; Production-Ready Django Social Network\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003e🚀 Full-Stack Social Media Platform | Real-time Chat | Smart News Feed | Open Source\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://img.shields.io/badge/version-2.0.0-red\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/version-2.0.0-red\" alt=\"version\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/Django-4.2+-green?logo=django\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Django-4.2+-green?logo=django\" alt=\"django badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/Python-3.8+-blue?logo=python\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Python-3.8+-blue?logo=python\" alt=\"python badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/Bootstrap-5.0+-purple?logo=bootstrap\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Bootstrap-5.0+-purple?logo=bootstrap\" alt=\"bootstrap badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/HTMX-1.8+-orange?logo=htmx\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/HTMX-1.8+-orange?logo=htmx\" alt=\"htmx badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/hosted%20on-render-purple?logo=render\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/hosted%20on-render-purple?logo=render\" alt=\"render badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/websockets-enabled-brightgreen?logo=fastapi\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/websockets-enabled-brightgreen?logo=fastapi\" alt=\"ws badge\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://img.shields.io/badge/License-MIT-yellow.svg\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"license badge\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003e **Bloome** is a production-grade Django social-media platform featuring a news-feed, real-time one-to-one chat, friend requests, likes, comments, and media uploads.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eTable of contents\u003c/strong\u003e\u003c/summary\u003e\n\n- [Live demo](#live-demo)\n- [June 2025 New Update](#-june-2025-new-update)\n- [Feature tour](#feature-tour)\n- [Tech stack](#tech-stack)\n- [Screenshots](#screenshots)\n- [Quick Start(Local Setup)](#quick-startlocal-setup)\n\u003c/details\u003e\n\n---\n\n## 🌐 Live demo\n\n🌐 **URL:** \u003chttps://bloome.onrender.com\u003e  \n🪄 **Demo account:** `demo@gmail.com` **Password:** `demo1234`  \n\n⚠️ *Free tier sleeps after 15 min idle; first hit may take ~30 s to spin up.*\n\n---\n\n## ✨ Feature tour\n\n- **News-feed** with likes, comments, and friend requests  \n- **Real-time chat** (WebSockets) with online presence  \n- **Async tasks** (Celery) powering welcome-email flow  \n- **Object storage** on Backblaze B2 (S3-compatible)  \n- **Zero-downtime deploys** on Render using Gunicorn + UvicornWorker  \n- **Responsive UI** built with Bootstrap 5 \u0026 HTMX  \n- **Modular settings** (`development.py`, `production.py`, `local.py`) ready for 12-factor apps  \n\n---\n\n## 🛠️ Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n\n| **Layer** | **Technologies** | **Purpose** |\n|-----------|------------------|-------------|\n| **🎨 Frontend** | Bootstrap 5, HTMX, JavaScript, CSS3 | Responsive UI, Real-time interactions |\n| **⚙️ Backend** | Django 4.2+, Django Channels, Python 3.8+ | Web framework, WebSocket support |\n| **🔄 Real-time** | Daphne ASGI, Redis, WebSockets | Async processing, Chat, Notifications |\n| **💾 Database** | SQLite (dev), MySQL/PostgreSQL (prod) | Data persistence, Relationships |\n| **☁️ Storage** | Backblaze B2 (S3-compatible) | Media files, Static assets |\n| **🚀 Deployment** | Render, Gunicorn, UvicornWorker | Production hosting, Load balancing |\n| **📧 Tasks** | Celery, Redis Broker | Background jobs, Email sending |\n\n\u003c/div\u003e\n\n---\n\n## 📸 Screenshots\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/680567a2-9bf2-4f3b-93a3-3b68ff28293e\" width=\"420\" alt=\"newsfeed\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/e98c0639-400c-4f8b-ac9c-d63a18c712fb\" width=\"320\" alt=\"chat list\"\u003e\u003cbr\u003e\u003cbr\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/cf7435d6-3848-481e-b390-b1680fc608a3\" width=\"420\" alt=\"profile\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/3f79e369-b11e-40ac-bbd9-6820a803eff7\" width=\"420\" alt=\"admin dashboard\"\u003e\n\u003c/p\u003e\n\n---\n\n## 📋 Quick Start(Local Setup)\n\nNote: You can add both MySQL or SQLite database. The configuration is added in the settings.py so you just have to uncomment the code and set database host, user, password and port. \n\nWarning: If you face any database related error then you have to add the information by using python-dot-env or directly in the code of MySQL setup.\n\nClone the repository \u0026 Navigate to the project directory:\n\n```bash\n  git clone https://github.com/emhash/Bloome\n\n  cd Bloome\n```\n\nCreate a virtual envoirnment:\n\n```bash \npython -m venv myenv\n```\nActive virtual envoirnment with Bash terminal:\n```bash \nsource myenv/Scripts/activate\n```\n(You can activate the virtual envoirnment using any terminal. Based on the terminal the activation process of virtual envoirnment might be different)\n\nNow install the necessary module \u0026 start the server:\n```bash \npip install -r requirements.txt\npython manage.py runserver\n\n```\n**In case of migration problem migrate and then run the server**\n```bash \npython manage.py makemigrations\npython manage.py migrate\n\n```\n\n\n\n\n---\n\n## 🚀 June 2025 New Update\n\n| Pillar | What’s new | Why it matters |\n|--------|------------|----------------|\n| **Architecture \u0026 DX** | Re-organised project into a layered folder structure. Added `.gitignore`, sample `.env`, and commented S3 settings. | Accelerates onboarding and prevents secrets leakage. |\n| **Real-time features** | One-to-one chat via **Django Channels** + **Daphne** (ASGI). | Demonstrates WebSocket and async proficiency. |\n| **Cloud storage** | Integrated Backblaze **B2 S3** bucket for media uploads. | Shows cost-efficient object-storage skills. |\n| **Modern hosting** | Migrated PythonAnywhere → **Render** native-ASGI. | Hands-on container/cloud deployment experience. |\n| **Email \u0026 tasks** | Automated welcome email + full **Celery + Redis** setup ready for future jobs. | Production-ready background-job architecture. |\n| **Security** | Fixed CSRF issues; secrets/hosts now env-driven. | Secure-by-default mindset. |\n\n\n\n---\n\n## 🤝 Contributing\n\nWe ❤️ contributions! Join our growing community of developers.\n\n### 🌟 **Ways to Contribute**\n- 🐛 **Bug Reports** - Help us improve\n- ✨ **Feature Requests** - Share your ideas  \n- 📝 **Documentation** - Improve our guides\n- 🔧 **Code Contributions** - Submit PRs\n- 🎨 **UI/UX Improvements** - Enhance the design\n- 🌍 **Translations** - Make it global\n\n### 🚀 **Quick Contribution Steps**\n1. **Fork** the repository\n2. **Create** your feature branch (`git checkout -b feature/AmazingFeature`)\n3. **Commit** your changes (`git commit -m 'Add AmazingFeature'`)\n4. **Push** to the branch (`git push origin feature/AmazingFeature`)\n5. **Open** a Pull Request\n\n### 🏆 **Contributors**\n\nThanks to all our amazing contributors! 🎉\n\n\u003ca href=\"https://github.com/emhash/Bloome/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=emhash/Bloome\" /\u003e\n\u003c/a\u003e\n\n---\n\n## 📊 Project Stats\n\n\u003cdiv align=\"center\"\u003e\n\n![GitHub stars](https://img.shields.io/github/stars/emhash/Bloome?style=social)\n![GitHub forks](https://img.shields.io/github/forks/emhash/Bloome?style=social)\n![GitHub watchers](https://img.shields.io/github/watchers/emhash/Bloome?style=social)\n\n![GitHub issues](https://img.shields.io/github/issues/emhash/Bloome)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/emhash/Bloome)\n![GitHub last commit](https://img.shields.io/github/last-commit/emhash/Bloome)\n\n\u003c/div\u003e\n\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### 🚀 **Ready to build the next big social platform?**\n\n**⭐ Star this repo** • **🍴 Fork it** • **📢 Share it** • **🤝 Contribute**\n\n**Made by [Md Emran Hossan Ashiq](https://github.com/emhash)**\n\n---\n\n*🔥 **Trending:** #Django #SocialMedia #Python #WebDevelopment #OpenSource #RealTime #FullStack*\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femhash%2Fbloome","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femhash%2Fbloome","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femhash%2Fbloome/lists"}