Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/shaaanuu/moviemania

Discover and explore movies effortlessly with MovieMania. It utilizes the TMDB api
https://github.com/shaaanuu/moviemania

Last synced: about 1 month ago
JSON representation

Discover and explore movies effortlessly with MovieMania. It utilizes the TMDB api

Awesome Lists containing this project

README

        

# 🎬 **MovieMania** - Your Ultimate Movie Guide

Welcome to **MovieMania**, the app designed to help you discover your next favorite movie! Powered by the **TMDB API**, MovieMania gives you access to a massive library of movies, from the latest blockbusters to hidden gems.

---

## πŸ“² Features

- **Browse Movies:** Explore trending, popular, top-rated, and upcoming movies. ✨
- **Search:** Easily find movies by title, genre, or release year. πŸ”
- **Movie Details:** Access rich details about your favorite moviesβ€”plots, cast, ratings, and more. πŸŽ₯

---

## πŸš€ Getting Started

1. **Clone the repository**

```bash
git clone https://github.com/shaaanuu/MovieMania.git
cd MovieMania
```

2. **Install dependencies**
Inside the project directory, run:

```bash
flutter pub get
```

3. **Get your TMDB API Key**
Go to [TMDB](https://www.themoviedb.org/) and sign up to get your API key.

4. **Set your API key**
Create a `api_key.dart` file in **_lib/core/_** and add your api key:

```dart
const apiKey="your_api_key_here"
```

5. **Run the app**
Once everything is set, run the app:
```bash
flutter run
```

---

## πŸ“„ License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## πŸ’¬ Contributing

We welcome contributions! If you'd like to improve **MovieMania**, here's how you can get involved:

1. **Fork** the repository to your GitHub account.
2. **Make your changes** and commit them with clear, descriptive messages (`git commit -am 'add: new feature'`).
3. **Push to your branch** (`git push origin feature-name`).
4. **Open a pull request** to the main repository.

Please make sure your code adheres to our coding style and passes the existing tests before submitting a pull request. If you have any questions or need help, feel free to open an issue. We're happy to help!