Skip to content

darshanm17/VibeWatcch

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 VibeWatch

VibeWatch is a sleek and user-friendly movie and TV show discovery web application built using React.js and TMDB API. It allows users to search, discover trending content, and manage their own personalized watchlist — all saved locally in the browser!


🚀 Features

  • 🔍 Search for any Movie or TV Show using keywords
  • 🎞️ Discover trending and top-rated content from The Movie Database (TMDB)
  • ❤️ Add to Watchlist feature using browser's local storage
  • 📱 Responsive UI that works great on mobile, tablet, and desktop
  • 🍿 Intuitive UI for browsing, viewing details, and exploring related content

🧰 Tech Stack

  • Frontend: React.js, HTML, CSS, JavaScript
  • API: TMDB (The Movie Database)
  • State Management: useState, useEffect
  • Storage: Local Storage for persistent watchlist
  • Styling: CSS Modules / Custom CSS
  • Routing: React Router DOM

📦 Installation

  1. Clone the repository

    git clone https://github.com/darshanm17/VibeWatch.git
    cd VibeWatch
  2. Install dependencies

    npm install
  3. Set up TMDB API Key

    • Create a .env file in the root directory.
    • Add the following line:
    REACT_APP_TMDB_API_KEY=your_tmdb_api_key
  4. Run the app

    npm start

    The app will open in your browser at http://localhost:3000.


📁 Folder Structure

VibeWatch/
├── public/
├── src/
│   ├── components/
│   │   ├── Navbar.jsx
│   │   ├── MovieCard.jsx
│   │   ├── Watchlist.jsx
│   ├── pages/
│   │   ├── Home.jsx
│   │   ├── Discover.jsx
│   │   ├── MovieDetails.jsx
│   ├── App.js
│   ├── index.js
├── .env
├── package.json
├── README.md

🖼️ Screenshots

Home Page Movie Details Watchlist
Home Details Watchlist

🌐 Live Demo

🚀 Check out the live version here: https://your-live-link.com


🧑‍💻 Author

Darshan M R
Final Year CSE Student at RV Institute of Technology and Management
🔗 GitHub • 📫 darshanmrd17@gmail.com


📜 License

This project is licensed under the MIT License.


📝 Notes

  • Make sure to keep your TMDB API Key secure and avoid exposing it in public repositories.
  • For production, consider integrating user authentication and storing watchlists in a database.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors