🎬 Use-Popcorn

Use-Popcorn is a React.js web application that allows users to search for movies and view detailed information about each movie using the OMDb API. Users can also add movies to a personalized watchlist, making it easy to keep track of films they want to watch.

🌐 Live Demo

A live version of Use-Popcorn can be found here.

📚 Table of Contents

• Features
• Installation
• Usage
• API Reference
• Contributing

✨ Features

• Movie Search: Search for any movie by title and view a list of results.
• Movie Details: Click on a movie to see details such as the title, year, genre, rating, director, cast, and plot summary.
• Add to Watchlist: Save movies to a watchlist to keep track of what you want to watch later.
• Responsive Design: Optimized for both desktop and mobile devices.

⚙️ Installation

1. Clone the repository:

   git clone https://github.com/vasudevsoni/use-popcorn.git
   cd use-popcorn
       

2. Install dependencies:

   npm install

3. Get an API key:
   • Sign up at OMDb API to obtain an API key.
   • Add this key to an .env file in the root of your project:

     REACT_APP_OMDB_API_KEY=your_api_key_here

4. Start the development server:

   npm start

5. Build for production:

   npm run build

🚀 Usage

1. Search for a Movie:
   • Use the search bar to look up movies by title.
2. View Movie Details:
   • Click on a movie from the search results to see detailed information.
3. Add to Watchlist:
   • Click the "Add to Watchlist" button on a movie's details page to save it to your watchlist.
4. View and Manage Watchlist:
   • Access your watchlist from the navigation bar, where you can view or remove movies.

📡 API Reference

This project utilizes the OMDb API for fetching movie data.

• Base URL: https://www.omdbapi.com/
• Parameters:
  • apikey (required): Your API key
  • s (optional): Movie title to search
  • i (optional): IMDb ID to get detailed movie data

Example request:

GET https://www.omdbapi.com/?apikey=your_api_key&s=inception

🤝 Contributing

Contributions are welcome! To contribute:

1. Fork the project.
2. Create a new branch (git checkout -b feature/your-feature).
3. Make your changes.
4. Commit and push your changes (git commit -m 'Add some feature').
5. Open a pull request.