Skip to content

Repository files navigation

🧠 MemeForge

Kotlin Jetpack Compose Firebase Room DB Gemini AI License: MIT GitHub all releases


MemeForge is a powerful and intelligent meme generator app for Android, designed using modern development tools. It allows users to browse, edit, and save memes — with AI-powered caption suggestions using Google Gemini, offline support, and Firebase-based authentication.


✨ Features

  • 🔐 Authentication with Firebase
    Sign in using Email/Password or Google

  • 🌐 Meme API Integration
    Fetches memes from the Imgflip API

  • ✍️ Meme Editing
    Customize meme templates and add captions

  • 🤖 AI Caption Generator
    Generate witty captions using Gemini AI

  • 💾 Save Favorites
    Save memes internally to favorites and to local device storage

  • 📶 Offline Support
    Caches memes locally using Room DB with refresh capability

  • 🎨 Modern UI
    Built with Jetpack Compose, dark mode toggle, and responsive layout


🧰 Tech Stack

  • Language: Kotlin
  • UI: Jetpack Compose + Material 3
  • Architecture: MVVM
  • Authentication: Firebase Auth (Email + Google)
  • Database: Room DB
  • Networking: Ktor Client
  • Image Loading: Coil
  • AI Integration: Google Gemini API
  • DI: Dagger-Hilt
  • Other: DataStore, Swipe Refresh

🚀 Getting Started

📦 Clone the Repository

git clone https://github.com/AryanPandeyDev/Meme-Forge.git
cd Meme-Forge

🛠️ Setup

  1. Open the project in Android Studio Hedgehog or newer
  2. Create a secret.properties file and add your Gemini API key:
API_KEY=your_gemini_api_key:
  1. Connect your Firebase project:

    • Enable Email and Google Sign-in
    • Download google-services.json
    • Place it inside the /app directory
  2. Sync Gradle and run the app on an emulator or real device


📸 Screenshots

HomeScreen WelcomeScreen SignUpScreen SlidingDrawerContents EditMemeScreen AiCaptionGenerator FavouriteMemesScreen


📌 Folder Structure

com.example.memeforge/
├── authentication/         # Firebase Auth logic
├── data/, datastore/, db/  # Room DB, offline caching
├── network/                # Ktor API logic
├── screens/                # Compose UI screens
├── viewmodels/             # ViewModels for state mgmt
├── di/                     # Dagger-Hilt setup
├── utils/, theme/, etc.

📄 License

This project is licensed under the MIT License.


🙌 Acknowledgements

🙌 Acknowledgements

About

Meme Forge is an free Android app built with Jetpack Compose & kotlin that lets users browse through list of memes templates, edit them , save them to their device ,and get AI-generated caption suggestions.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages