MANSHOOR 📱

MANSHOOR is an advanced social media platform designed for seamless interaction through posts, animated like and dislike buttons, and nested comments. With powerful search functionality and integration with Google Gemini for content moderation, MANSHOOR ensures a safe and engaging user experience.

Table of Contents

• Features
• Installation
• Usage
• Screenshots
• Architecture
• Dependencies
• Contributing
• License

Features ✨

• Animated Like/Dislike Buttons: Enhance user engagement with intuitive animations.
• Nested Comments: Streamlined conversation threads for better interaction.
• Advanced Search: Find posts quickly and efficiently.
• Content Moderation: Integrated with Google Gemini for AI-powered moderation.
• Secure Authentication: Firebase authentication with support for various sign-in methods.
• Real-time Data: Seamless integration with Firebase Firestore and Cloud Messaging.

Installation 🛠️

To get started with MANSHOOR, follow these steps:

1. Clone the repository:

   git clone https://github.com/your-username/manshoor.git
   cd manshoor

2. Set up the project:

   • Open the project in Android Studio.
   • Sync Gradle files.

3. Add your Firebase configuration:

   • Download your google-services.json from Firebase Console.
   • Place it in the app/ directory.

4. Build and Run:

   • Compile the project using the latest version of Android Studio.
   • Run on an emulator or a physical device.

Usage 🚀

1. Create an Account:

   • Sign up using your email or Google account.

2. Make a Post:

   • Use the "Create Post" button to share your thoughts with the world.

3. Engage with Others:

   • Like, dislike, and comment on posts.

4. Search:

   • Use the search bar to find specific posts.

Screenshots 📸

(Include a folder or placeholders for screenshots here)

Home Screen	Login Screen	Comments Section

Create Screen	Search Screen

Architecture 🏗️

MANSHOOR follows a modern, modular architecture ensuring scalability and maintainability:

• MVVM: For clear separation of concerns.

• Jetpack Compose: Modern UI toolkit.

• Koin: Dependency injection for better testability and modularity.

• Ktor: HTTP client for networking.

• Realm: Database for local data storage and synchronization.

Dependencies 📦

The project uses a variety of libraries to provide a robust and feature-rich experience:

• Kotlinx Serialization: For handling JSON data.
• Ktor: For networking and API calls.
• Firebase: For authentication, Firestore, and messaging.
• Realm: For local database and syncing.
• Jetpack Compose: For building the UI.
• Generative AI (Google Gemini): For content moderation.

For a full list, see the build.gradle.kts file.

Contributing 🤝

Contributions are welcome! Please submit a pull request or open an issue to discuss any changes.

License 📄

This project is licensed under the MIT License. See the LICENSE file for details.