π¬ BingeBox β Your Ultimate Movie and TV Show Explorer BingeBox is a React-based web app that allows users to explore trending movies and TV series using data from The Movie Database (TMDb) API. Users can easily add their favorite content to a personalized list, and enjoy a smooth browsing experience with an intuitive UI.
β¨ Features Browse Trending Movies and TV Shows: Powered by TMDb API Add/Remove Favorites: Save your favorite movies and TV shows for later viewing Dynamic Filtering and Display: Smooth transitions and UI enhancements with Tailwind CSS Toast Notifications: Instant feedback using react-hot-toast State Management: Combination of Redux Toolkit and Context API Routing: Seamless navigation with react-router-dom
π Technologies Used React β UI Library Redux Toolkit β For global state management Context API β For managing lightweight state react-router-dom β For routing and navigation react-hot-toast β For notifications Tailwind CSS β For styling and responsive design TMDb API β Data source for movies and TV shows
π¦ Installation Clone the repository
bash Copy Edit git clone https://github.com/Hadiquaa/BingeBox-Tmdb.git cd BingeBox-Tmdb Install dependencies
bash Copy Edit yarn install Set up environment variables Create a .env file in the root directory and add your TMDb API key:
ini Copy Edit REACT_APP_TMDB_API_KEY=your_api_key_here Start the development server
bash Copy Edit yarn start
π Usage Home Page: Displays the most popular movie and TV series. Favorites: View a grid of your favorite content, with an option to remove them. Add to Favorites: Use the heart icon on any movie/TV show to add it to your favorites. Remove from Favorites: Accessible through the Favorites page.
π‘ Future Improvements Add pagination for better content browsing Include user authentication for personalized watchlists
π License This project is licensed under the MIT License.
π€ Contributing Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
π¬ Contact Author: Hadiqa Taiba GitHub: Hadiquaa Email: hadiqua350@gmail.com