Skip to content

Repository files navigation

🎬 MovieManiac

Flutter Dart License

MovieManiac is your ultimate companion for discovering movies and TV series. With a sleek, Tinder-style swipe interface, finding your next binge-watch has never been easier. Powered by the OMDb API, it helps you curate your personal library of favorites, watch lists, and seen content.


✨ Features

  • 🔥 Swipe to Discover:

    • Swipe Right to ❤️ Like.
    • Swipe Left to ❌ Dislike.
    • Swipe Down to ⏱️ Add to Watch Later.
    • Swipe Up to ✅ Mark as Watched.
  • 📺 Movies & Series Support: Toggle instantly between browsing Movies and TV Series.

  • 📚 Smart Library: Organize your content into:

    • Liked Collection
    • Watch Later Queue
    • Watched History
  • 💬 Random Quotes: Get daily inspiration (or a laugh) with random quotes from:

    • Anime
    • Lucifer
    • Parks and Recreation
    • Stranger Things
  • 🌗 Dark Mode: A premium, dark-themed UI designed for movie lovers.

  • 💾 Offline Persistence: Your lists are saved locally so you never lose track.


🚀 Getting Started

Prerequisites

  • Flutter SDK
  • An OMDb API Key (The app includes a default one, but you may want to use your own).

Installation

  1. Clone the repository:

    git clone https://github.com/shad-ct/movieManiac.git
    cd movieManiac
  2. Install dependencies:

    flutter pub get
  3. Run the app:

    flutter run

🛠️ Tech Stack

  • Framework: Flutter
  • State Management: Provider
  • Networking: HTTP
  • UI Components: flutter_card_swiper, cached_network_image, google_fonts
  • Local Storage: shared_preferences

📷 Screenshots

Swipe Interface Home Quotes Liked
Home quotes liked
Watched Watch Later
watched watch later

🤝 Contributing

Contributions are welcome! If you have suggestions or find a bug, please open an issue or submit a pull request.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

Distributed under the MIT License. See LICENSE for more information.

About

A smart discovery app for Movies & TV Series featuring a swipeable interface, personal watchlists, and pop-culture quotes. Built with Flutter

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages