Skip to content

BingeBucket is a powerful, user-friendly application designed to enhance your binge-watching experience. Whether you're a movie buff, TV show enthusiast, or just looking for something new to watch, BingeBucket has you covered. 🍿

License

Notifications You must be signed in to change notification settings

mohammedkharoda/BingeBucket

Repository files navigation

🎬 Binge Bucket - Movies & Series 🍿

Welcome to Binge Bucket, your ultimate destination for exploring the finest collection of movies and series! With a curated selection and a user-friendly interface, Binge Bucket aims to enhance your entertainment experience with ease.

📌 Overview

Binge Bucket is designed to offer users an easy and engaging way to discover popular movies and series. The site features a visually appealing layout with vibrant posters, quick access to popular and trending shows, and personalized recommendations.

✨ Features

  • Dynamic Content Discovery: Easily explore top movies and series with a beautiful grid layout.
  • Mood-Based Suggestions: Our "Surprise Me" section curates recommendations based on your mood.
  • Responsive Design: Seamless experience across desktop and mobile devices.
  • Search the Next Big Hit: Find your favorite movies or series quickly with our intuitive search functionality.
  • User-Friendly Navigation: Navigate through Home, Movies, Series, and more with an easy-to-use header menu.

🖥️ Desktop Preview

Desktop Preview

📱 Mobile Preview

Mobile Preview
Experience the best of Binge Bucket on the go with a fully responsive mobile layout.

🚀 Getting Started

1. Prerequisites

Ensure you have the following installed:

  • Node.js v16+
  • npm

2. Installation

Clone the repository and install dependencies:

git clone https://github.com/mohammedkharoda/BingeBucket.git
cd binge-bucket
npm install

3. Running the App

Start the development server:

npm run dev

⭐ Key Components

  • Home: Discover top picks, trending shows, and more.
  • Movies & Series: Dive into dedicated sections for movies and TV series.
  • Surprise Me: Let us suggest something special based on your mood.
  • Search: Find any movie or series instantly with our advanced search bar.

📚 Tech Stack

  • Framework: Next.js 14
  • Styling: Tailwind CSS for responsive and elegant designs.
  • State Management: Zustand for efficient state handling.
  • Authentication: Kinde Auth for secure user authentication.
  • API: Integrated with TMDB API for fetching movie and series data.

⚙️ Custom Hooks and API Integration

  • Custom hooks with React Query for fetching data efficiently.
  • Debounced and validated search input to enhance user experience.

🔧 Future Enhancements

  • Rating System: User ratings and reviews to provide feedback.
  • Watchlist: Save and organize your favorite movies and series.
  • Enhanced Mood-Based Suggestions: Refine recommendations with user data.

About

BingeBucket is a powerful, user-friendly application designed to enhance your binge-watching experience. Whether you're a movie buff, TV show enthusiast, or just looking for something new to watch, BingeBucket has you covered. 🍿

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published