Skip to content

Movie Maze is a Flutter app that allows users to search for movies and TV shows using the TVMaze API. It features a visually appealing grid-based UI, detailed movie pages, and seamless navigation between search and details screens. Built with Flutter and Dart, this app showcases responsive design and a Netflix-inspired dark theme.

License

Notifications You must be signed in to change notification settings

Siddiqui145/movie_maze

Repository files navigation

🎥 Movie Maze

Movie Maze is a Flutter-based application that allows users to search for their favorite movies and shows using the TVMaze API. The app features a clean and visually appealing interface with dynamic search functionality and detailed movie information.


📱 Features

  • Movie Search: Search for movies and shows in real-time using the TVMaze API.
  • Dynamic Grid View: Display search results in a stylish grid format, complete with movie posters, titles, and summaries.
  • Detail Navigation: Tap on any movie to navigate to its detailed page.
  • Themed Design: Modern dark theme with consistent aesthetics.
  • Responsive UI: Optimized for various screen sizes and orientations.

🛠️ Technologies Used

  • Flutter: Frontend framework for building the app.
  • Dart: Programming language for Flutter development.
  • TVMaze API: Source of movie and TV show data.
  • HTTP: To fetch data from the API.
  • Material Design: For building the user interface.

🚀 Getting Started

Prerequisites

  • Install Flutter: Flutter Installation Guide
  • Set up an IDE (e.g., Visual Studio Code, Android Studio).
  • Clone the repository to your local machine:
    git clone https://github.com/Siddiqui145/movie_maze.git

Installation

  1. Navigate to the project directory:
    cd movie_maze
  2. Get the required packages:
    flutter pub get
  3. Run the app:
    flutter run

🌟 Demo

Movie_maze_trial.mp4

📡 API Integration

The app uses the TVMaze API to fetch movie and TV show data.
API endpoint used for search:

https://api.tvmaze.com/search/shows?q={query}

📂 Project Structure

lib/
├── main.dart                # Entry point of the app
├── screens/
│   ├── search_screen.dart   # Main search screen
│   ├── details_screen.dart  # Details page for movies
│   ├── home_screen.dart     # Home page for movies
│   ├── splash_screen.dart   # Splash image for opening
├── assets/
│   ├── images/              # Placeholder images


🚧 Future Enhancements

  • Offline Support: Cache movie data for offline viewing.
  • Favorites Feature: Allow users to save their favorite movies.
  • Expanded Details: Include more detailed information (cast, episodes, etc.).
  • Animations: Add transitions and animations for a smoother experience.

🤝 Contribution

Contributions are welcome! If you have suggestions, feel free to create an issue or open a pull request.

Steps to Contribute:

  1. Fork the repository.
  2. Create a new branch:
    git checkout -b feature-name
  3. Make your changes and commit:
    git commit -m "Add feature-name"
  4. Push your changes:
    git push origin feature-name
  5. Open a pull request.

📝 License

This project is licensed under the MIT License.
See the LICENSE file for more details.


💻 Author

Developed by [Taha Siddiqui] ([(https://github.com/Siddiqui145)]).
Feel free to reach out or connect with me for queries or suggestions!

About

Movie Maze is a Flutter app that allows users to search for movies and TV shows using the TVMaze API. It features a visually appealing grid-based UI, detailed movie pages, and seamless navigation between search and details screens. Built with Flutter and Dart, this app showcases responsive design and a Netflix-inspired dark theme.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published