https://github.com/aymen016/minisocial
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.
https://github.com/aymen016/minisocial
css facebook-clone flask html mongodb python tailwindcss
Last synced: 5 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/aymen016/minisocial
- Owner: Aymen016
- Created: 2024-12-21T18:51:44.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-24T05:50:50.000Z (12 months ago)
- Last Synced: 2025-09-04T19:45:21.992Z (10 months ago)
- Topics: css, facebook-clone, flask, html, mongodb, python, tailwindcss
- Language: CSS
- Homepage:
- Size: 72.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌟 MiniSocial - A Mini Facebook Clone 🌟
Welcome 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.
## 🚀 Features
- ✍️ **Create Posts**: Share your thoughts with friends and followers.
- 📸 **Upload Images**: Make your posts visually appealing with image uploads.
- 💬 **Comment on Posts**: Engage with others by adding comments.
- ❤️ **React to Posts**: Show your love for posts with likes and love reactions.
- 👥 **Friends and Followers**: Display friends and followers with user stats.
- 🛠️ **Responsive Design**: Optimized for all devices.
## 🖥️ Tech Stack
- **Frontend**: HTML, CSS (with TailwindCSS for responsiveness).
- **Backend**: Python (Flask) and MongoDB.
- **Database**: MongoDB for storing user, post, and comment data.
## 🛠️ Installation
Follow these steps to set up the project locally:
1. Clone the repository:
```bash
git clone https://github.com/your-username/minisocial.git
cd minisocial
```
2. Set up a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # For Linux/Mac
venv\Scripts\activate # For Windows
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
4. Start the Flask app:
```bash
python app.py
```
5. Open your browser and navigate to:
```bash
http://127.0.0.1:5000
```
---
## 🛠️ Customization
- Modify **config.py** to update database connection details.
- Customize **templates/** to change UI and branding.
- Extend **models.py** to add new features and data relationships.
## 🔥 Future Enhancements
- 🔹 **Real-time Chat System** 💬
- 🔹 **Story Feature** 📸
- 🔹 **Notification System** 🔔
- 🔹 **Dark Mode Toggle** 🌙
## 📝 License
This project is licensed under the **MIT License**.
## 🤝 Contributors
👤 **Aymen** - [GitHub](https://github.com/Aymen016) | [LinkedIn](https://linkedin.com/in/aymen-baig-700a06284/)
## 🌟 Support & Feedback
If you like **MiniSocial**, don't forget to ⭐ **star** the repo! Have suggestions or improvements? Open an issue or reach out! 🚀