{"id":23564251,"url":"https://github.com/aymen016/minisocial","last_synced_at":"2026-02-14T10:03:08.530Z","repository":{"id":313242510,"uuid":"906737024","full_name":"Aymen016/MiniSocial","owner":"Aymen016","description":"MiniSocial is a lightweight Facebook clone built with Flask and MongoDB. It lets users create posts, upload images, react, comment, and connect with others — all in a clean, responsive UI.","archived":false,"fork":false,"pushed_at":"2025-07-24T05:50:50.000Z","size":76386,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-04T19:45:21.992Z","etag":null,"topics":["css","facebook-clone","flask","html","mongodb","python","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":"CSS","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/Aymen016.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":"2024-12-21T18:51:44.000Z","updated_at":"2025-07-24T05:53:36.000Z","dependencies_parsed_at":"2025-09-04T19:45:23.540Z","dependency_job_id":"c6426746-267e-4524-a5b1-2c75d51c7699","html_url":"https://github.com/Aymen016/MiniSocial","commit_stats":null,"previous_names":["aymen016/minisocial"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Aymen016/MiniSocial","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FMiniSocial","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FMiniSocial/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FMiniSocial/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FMiniSocial/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Aymen016","download_url":"https://codeload.github.com/Aymen016/MiniSocial/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Aymen016%2FMiniSocial/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29442334,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-14T07:24:13.446Z","status":"ssl_error","status_checked_at":"2026-02-14T07:23:58.969Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["css","facebook-clone","flask","html","mongodb","python","tailwindcss"],"created_at":"2024-12-26T17:13:37.731Z","updated_at":"2026-02-14T10:03:08.526Z","avatar_url":"https://github.com/Aymen016.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌟 MiniSocial - A Mini Facebook Clone 🌟\n\nWelcome to **MiniSocial**, a sleek and modern clone of Facebook! This project mimics key features of the popular social media platform, allowing users to post, like, comment, and connect with others in an elegant UI.\n\n\u003cimg width=\"1886\" height=\"763\" alt=\"Profile\" src=\"https://github.com/user-attachments/assets/cfb96321-50b9-4cd9-a9eb-707448232cab\" /\u003e\n\n\n## 🚀 Features\n- ✍️ **Create Posts**: Share your thoughts with friends and followers.\n- 📸 **Upload Images**: Make your posts visually appealing with image uploads.\n- 💬 **Comment on Posts**: Engage with others by adding comments.\n- ❤️ **React to Posts**: Show your love for posts with likes and love reactions.\n- 👥 **Friends and Followers**: Display friends and followers with user stats.\n- 🛠️ **Responsive Design**: Optimized for all devices.\n\n## 🖥️ Tech Stack\n- **Frontend**: HTML, CSS (with TailwindCSS for responsiveness).\n- **Backend**: Python (Flask) and MongoDB.\n- **Database**: MongoDB for storing user, post, and comment data.\n\n## 🛠️ Installation\nFollow these steps to set up the project locally:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/your-username/minisocial.git\n   cd minisocial\n   ```\n\n2. Set up a virtual environment:\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # For Linux/Mac\n   venv\\Scripts\\activate     # For Windows\n   ```\n\n3. Install dependencies:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. Start the Flask app:\n   ```bash\n   python app.py\n   ```\n   \n5. Open your browser and navigate to:\n   ```bash\n   http://127.0.0.1:5000\n   ```\n   ---\n   ## 🛠️ Customization\n\n- Modify **config.py** to update database connection details.\n- Customize **templates/** to change UI and branding.\n- Extend **models.py** to add new features and data relationships.\n\n## 🔥 Future Enhancements\n\n- 🔹 **Real-time Chat System** 💬\n- 🔹 **Story Feature** 📸\n- 🔹 **Notification System** 🔔\n- 🔹 **Dark Mode Toggle** 🌙\n\n## 📝 License\n\nThis project is licensed under the **MIT License**.\n\n## 🤝 Contributors\n\n👤 **Aymen** - [GitHub](https://github.com/Aymen016) | [LinkedIn](https://linkedin.com/in/aymen-baig-700a06284/)\n\n## 🌟 Support \u0026 Feedback\n\nIf you like **MiniSocial**, don't forget to ⭐ **star** the repo! Have suggestions or improvements? Open an issue or reach out! 🚀\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faymen016%2Fminisocial","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faymen016%2Fminisocial","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faymen016%2Fminisocial/lists"}