🎬 Movie Surf: A Flutter Application

Movie Surf is a Flutter application that provides users with a seamless Movie and TV show browsing experience using The Movie Database (TMDb) API. The app allows users to discover Movies and TV shows, view detailed information, and explore popular, upcoming, and top-rated content.

---

✨ Features:

• Fetch and display popular, top-rated, and upcoming Movies and Tv Shows.
• Search for movies and TV shows using Search with Query Submission.
• View detailed information, including poster, release date, overview, ratings, and recommendations.
• Browse and view similar and recommended Movies and TV shows.
• Attractive and user-friendly UI for smooth navigation.

---

📱 Technologies Used:

• Flutter (for building the UI)
• Dart (for application logic and API handling)
• HTTP Package (for making API requests)
• Shared Preferences (for storing user preferences locally)
• Google Fonts & Lottie (for improved UI/UX)

---

📌 Dependencies:

The following dependencies are used in this project:

    http: ^1.3.0
    flutter_dotenv: ^5.2.1
    google_fonts: ^6.2.1
    flutter_svg: ^2.0.17
    image_picker: ^1.1.2
    shared_preferences: ^2.5.2
    lottie: ^3.3.1

---

🔗 API Integration:

The app integrates with The Movie Database (TMDb) API to fetch real-time movie and TV show data. More details about the API can be found here. and, The following APIs are used in this project:

🎥 Movie APIs:

Upcoming Movies:

https://api.themoviedb.org/3/movie/upcoming?api_key=[Your-API-Key]&page=[PageNumber]

Now Playing Movies:

https://api.themoviedb.org/3/movie/now_playing?api_key=[Your-API-Key]&page=[PageNumber]

Movie Images:

https://api.themoviedb.org/3/movie/[MovieID]/images?api_key=[Your-API-Key]

Similar Movies:

https://api.themoviedb.org/3/movie/[MovieID]/similar?api_key=[Your-API-Key]

Recommended Movies:

https://api.themoviedb.org/3/movie/[MovieID]/recommendations?api_key=[Your-API-Key]

Search Movie:

https://api.themoviedb.org/3/search/movie?query=[MovieName]&api_key=[Your-API-Key]

📺 TV Show APIs:

Popular TV Shows:

https://api.themoviedb.org/3/tv/popular?api_key=[Your-API-Key]

Top Rated TV Shows:

https://api.themoviedb.org/3/tv/top_rated?api_key=[Your-API-Key]

Airing Today TV Shows:

https://api.themoviedb.org/3/tv/airing_today?api_key=[Your-API-Key]

TV Show Images:

https://api.themoviedb.org/3/tv/[TvShowID]/images?api_key=[Your-API-Key]

Similar TV Shows:

https://api.themoviedb.org/3/tv/[TvShowID]/similar?api_key=[Your-API-Key]

Recommended TV Shows:

https://api.themoviedb.org/3/tv/[TvShowID]/recommendations?api_key=[Your-API-Key]

Search TV Show:

https://api.themoviedb.org/3/search/tv?query=[TvShowName]&api_key=[Your-API-Key]

🖼️ Image Base URL:

https://image.tmdb.org/t/p/w500/[ImageName]

---

📌 Setup Instructions:

1. Clone the Repository:

   https://github.com/PAIshanMadusha/MovieSurf-Application.git

2. Setting Up the TMDb API Key:

• Obtain an API key from TMDb.

• Create a .env file in the root of project.

• Add your API key to the .env file:

  MY_MOVIE_API_KEY = [Your-API-Key]

• Replace [Your-API-Key] with your actual API key from TMDb.

3. Install Dependencies:

   flutter pub get

4. Run the App:

   flutter run

---

📸 System Screenshots:

                    

               

                    

---

👤 About This Project:

Movie Surf is a Flutter app that allows users to explore movies and TV shows using the TMDb API. It lets users browse upcoming movies, now-playing films, popular TV shows, and search for specific titles. Also, Movie Surf aims to provide an enjoyable and efficient way for users to stay updated with their favorite movies and TV shows.

👨‍💻 Created by:

Ishan Madhusha
GitHub: PAIshanMadusha

Feel free to explore my work and get in touch if you'd like to collaborate! 🚀

---

📝 License

This project is open-source and available under the MIT License.