MasterMeme - Your Ultimate Meme Experience

MasterMeme is a fun and engaging Android application built with Jetpack Compose, designed to bring you a delightful collection of memes from various sources. Browse, laugh, and share your favorite memes with ease!

✨ Features

Browse a vast collection of memes: Discover a wide range of memes fetched from popular meme APIs.

Smooth and intuitive UI: Enjoy a seamless user experience powered by Jetpack Compose.

Pull-to-refresh: Easily update the meme feed with the latest content.

Save your favorite memes: Mark memes as favorites to access them quickly later.

Share memes with friends: Share your favorite memes directly to other apps.

Clean and modern design: A visually appealing interface that's easy on the eyes.

📱 Screenshots

(Include screenshots of your app here to showcase the UI and features. If you don't have them readily available, you can add placeholders like "[Screenshot of Meme Feed]", "[Screenshot of Favorites Screen]", etc., and replace them later.)

Meme Feed: [Screenshot of Meme Feed]

Favorites Screen: [Screenshot of Favorites Screen]

Meme Detail/Share: [Screenshot of Meme Detail/Share]

🚀 Tech Stack

Android Jetpack Compose: Modern declarative UI toolkit for Android.

Kotlin: The primary programming language.

Coil: An image loading library for Android backed by Kotlin Coroutines.

ViewModel: For managing UI-related data in a lifecycle-conscious way.

Coroutines and Flow: For asynchronous operations and managing data streams.

Dependency Injection (e.g., Koin - specify if used): For managing dependencies.

Android Architecture Components: Leveraging LiveData/StateFlow, Room (if database is used for favorites), etc.

⚙️ Setup and Installation

Clone the repository:

git clone https://github.com/WalkerAlone764/MasterMeme.git

Open the project in Android Studio: Launch Android Studio and select "Open an existing Android Studio project". Navigate to the cloned repository directory and open it.

Build the project: Once the project is loaded, Gradle will start syncing. After syncing is complete, you can build the project by going to Build > Make Project or by running the app on a connected device or emulator.

Run the application: Select a connected Android device or an emulator in Android Studio and click the "Run" button (the green play icon) to install and launch the MasterMeme app.

🛠️ Development

Feel free to contribute to the development of MasterMeme! If you find any bugs, have suggestions for new features, or want to submit improvements, please:

Fork the repository: Create your own fork of the MasterMeme repository.

Create a new branch: Make your changes in a separate branch.

git checkout -b feature/your-feature-name

Make your contributions: Implement your changes and ensure the code follows the project's coding style.

Commit your changes: Write clear and concise commit messages.

git commit -m "Add your feature or fix"

Push to your fork: Push your local branch to your remote fork.

git push origin feature/your-feature-name

Create a Pull Request: Go to the original MasterMeme repository on GitHub and create a new pull request from your forked repository and branch.

🙏 Acknowledgements

Thanks to the developers of the open-source libraries used in this project.

Appreciation to the meme APIs for providing the awesome content.

🙋‍♂️ Contact

If you have any questions or suggestions, feel free to reach out!

Email - jatinsinghal404@gmail.com linkedin - https://www.linkedin.com/in/jatin-singhal-590592210/

Enjoy your daily dose of laughter with MasterMeme!