Skip to content

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.

Notifications You must be signed in to change notification settings

Aymen016/MiniSocial

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌟 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.

Profile

🚀 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:

    git clone https://github.com/your-username/minisocial.git
    cd minisocial
  2. Set up a virtual environment:

    python -m venv venv
    source venv/bin/activate  # For Linux/Mac
    venv\Scripts\activate     # For Windows
  3. Install dependencies:

    pip install -r requirements.txt
  4. Start the Flask app:

    python app.py
  5. Open your browser and navigate to:

    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 | LinkedIn

🌟 Support & Feedback

If you like MiniSocial, don't forget to ⭐ star the repo! Have suggestions or improvements? Open an issue or reach out! 🚀

About

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.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published