Skip to content

Repository files navigation

🎬 Movie App

A Modern & Responsive Movie Discovery Platform built with React & Vite.


πŸ“– About The Project

Movie App is a modern and fully responsive movie discovery platform built with React and Vite, powered by The Movie Database (TMDB) API.

The application allows users to discover trending movies, browse TV series and anime, search for their favorite titles, watch official trailers, explore recommendations, and save movies to their favorites.

The project focuses on delivering a clean, responsive, and smooth browsing experience while following modern React development practices and reusable component architecture.


πŸš€ Live Demo

🌐 Website

https://cinemax-devils.vercel.app/


✨ Features

  • πŸ”₯ Browse Trending Movies
  • ⭐ Discover Top Rated Movies
  • 🎬 Explore Popular Movies
  • πŸ“Ί Browse TV Series
  • 🎌 Explore Anime
  • πŸ” Search Movies & TV Shows
  • πŸ“„ Detailed Movie Information
  • πŸŽ₯ Watch Official Trailers
  • πŸ’‘ Related & Recommended Movies
  • ❀️ Add & Remove Favorites
  • ⭐ Movie Ratings
  • πŸ“± Fully Responsive Design
  • ⚑ Fast & Smooth User Experience
  • 🎨 Clean & Modern UI

πŸ›  Tech Stack

Front-End

  • React
  • Vite
  • JavaScript (ES6+)

Styling

  • Tailwind CSS
  • CSS3
  • AOS Animation

API

  • TMDB API
  • Axios

Routing

  • React Router DOM

UI Libraries

  • React Icons
  • Font Awesome

Deployment

  • Vercel

πŸ“Έ Screenshots

Home Search
🏠 Home πŸ” Search
Trending Movies TV Series
πŸ”₯ Trending Movies πŸ“Ί TV Series
Movie Details Recommendations
🎬 Movie Details πŸ’‘ Recommendations
Favorites
❀️ Favorites

βš™οΈ Getting Started

Clone the repository

git clone https://github.com/Mohamedxismail/devil-s
.git

Navigate to the project folder

cd movie-app

Install dependencies

npm install

Create a .env file and add your TMDB API Key.

Example:

VITE_TMDB_API_KEY=YOUR_API_KEY

Run the development server

npm run dev

Open your browser

http://localhost:5173

πŸ“ Project Structure

src
β”‚
β”œβ”€β”€ assets
β”œβ”€β”€ components
β”œβ”€β”€ pages
β”œβ”€β”€ context
β”œβ”€β”€ hooks
β”œβ”€β”€ services
β”œβ”€β”€ router
β”œβ”€β”€ App.jsx
└── main.jsx

🎬 API

This project uses The Movie Database (TMDB) API to provide:

  • πŸ”₯ Trending Movies
  • ⭐ Top Rated Movies
  • 🎬 Popular Movies
  • πŸ“Ί TV Series
  • 🎌 Anime
  • πŸ” Search
  • πŸ“„ Movie Details
  • πŸŽ₯ Official Trailers
  • πŸ’‘ Recommendations
  • ⭐ Ratings

πŸš€ Deployment

The application is deployed on Vercel.

🌐 Live Website

https://cinemax-devils.vercel.app/


πŸš€ Future Improvements

The project can be extended with more advanced features in the future, including:

  • πŸ‘€ User Authentication
  • πŸ“ User Reviews & Comments
  • 🎭 Cast & Crew Details
  • πŸ“Ί Streaming Platform Availability
  • 🌍 Multi-language Support (i18n)
  • πŸŒ™ Dark Mode
  • 🎞 Watchlist
  • πŸ”” Personalized Movie Recommendations
  • πŸ“Š Movie Statistics Dashboard
  • πŸ“± Progressive Web App (PWA)
  • πŸŽ₯ Upcoming Movies Calendar
  • πŸ€– AI Movie Recommendations

πŸ“± Responsive Design

The application is fully responsive and optimized for all devices:

  • πŸ’» Desktop
  • πŸ’Ό Laptop
  • πŸ“± Tablet
  • πŸ“² Mobile

πŸ“š What I Learned

Developing Movie App helped me improve my skills in:

  • Building React Applications with Vite
  • Working with REST APIs
  • Integrating TMDB API
  • React Router DOM
  • Axios
  • State Management using Context API
  • Reusable React Components
  • Search Functionality
  • Responsive Design with Tailwind CSS
  • AOS Scroll Animations
  • Favorites Management
  • Error Handling & Loading States
  • Clean Project Structure & Code Organization

πŸ‘¨β€πŸ’» Author

Mohamed Ismail

Frontend Developer

🌐 GitHub

https://github.com/Mohamedxismail

πŸ’Ό LinkedIn

https://www.linkedin.com/in/mohamed-ismail-81217a33b

πŸš€ Live Demo

https://cinemax-devils.vercel.app/


🀝 Contributing

Contributions, issues, and feature requests are welcome.

If you'd like to improve this project:

  1. Fork the repository.
  2. Create a new branch.
  3. Commit your changes.
  4. Open a Pull Request.

⭐ Support

If you like this project, don't forget to leave a ⭐ on GitHub.

Your support motivates me to build more awesome projects.


Made with ❀️ by Mohamed Ismail using React & Vite

About

A modern movie discovery app built with React and TMDB API to explore movies, TV series, anime, trailers, ratings, and trending content.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages