Skip to content

hacanand/Movie-Explorer

Repository files navigation

Movie Explorer

Movie Explorer is a React-based movie website that allows users to search for movies by title, sort them by genre, view trending and upcoming movies, The website is designed to be user-friendly and visually appealing.

🍿 Features

  • Search and watch movies: users can search for movies by title and can watch them easily
  • Genre-wise display: movies can be sorted by genre
  • Trending Movies: displays a section for trending movies
  • Movie Details: users can view detailed information about each movie

🍿 Technology

Movie Explorer is built using the following technologies:

  • ReactJS
  • Tailwind css
  • TVDB API
  • Framer Motion

🍿 How to Run the Website on Your System

Step 1: Download and Extract the Code

  • Firstly, download the entire website code and extract the ZIP file to a folder on your local system.
  • Or clone the project using git clone

Step 2: Obtain the TVDB Movies API Key

Before starting the website, you will need to obtain the TVDB Movies API key. Follow these steps to obtain them and add them to your .env file.

▶️ Get TVDB API Key

  • Go to https://thetvdb.com/api-information and log in.
  • Click on your user profile picture in the navigation bar, and select "Dashboard".
  • In the Dashboard, select "API" and generate an API key.
  • then generate access token using api key and add it to .env file

Step 3: Run the Website

Open your code editor (such as VS Code) and navigate to the project directory. Then, open a terminal and run the following command:

cd `root directory`
npm install
npm run dev

This will start the application. Open a web browser and navigate to http://localhost:3000 to access the website.

Note: Ensure that you have carefully added the TVDB API key in .env file. If the .env file is not working, add all the API keys and configuration manually.


🍿 Demo

😍 Contribution

Contributions are always welcome, open a Pull Request and help us improve our project.