Skip to content

Kaviselvan-SJ/Movie_Finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 Movie Finder

Movie Finder is a modern React-based application built with Vite. It allows users to browse popular movies, search for specific titles, and save favourite movies. It uses clean, responsive design and organizes logic using components, contexts, and modular CSS.


🔗 Live Demo

👉 Click here

🚀 Features

  • 🔍 Search Movies: Instantly fetch movies based on your query.
  • 🌟 Popular Movies: Loads trending movies on startup.
  • ❤️ Favourites: Add and view your favourite movies.
  • 🧠 Context API: Manage global favourite state.
  • Fast & Responsive UI: Built with Vite and modular CSS.

🖼️ Preview

Preview 1

Preview 2

Preview 3

🛠️ Project Setup

1. Clone the Repository

git clone https://github.com/your-username/movie-finder.git
cd movie-finder

2. Install Dependencies

npm install

3. Add Environment Variable

Create a .env file in the root directory:

VITE_API_KEY=your_api_key_here

💡 Replace your_api_key_here with your TMDB or OMDB API key.

4. Start the Development Server

npm run dev

📁 Folder Structure

movie-finder/
│
├── public/
├── src/
│   ├── assets/               # Images or logos
│   ├── components/           # Reusable components (MovieCard, NavBar)
│   ├── contexts/             # MovieContext for managing favourites
│   ├── css/                  # Modular CSS files
│   │   ├── App.css
│   │   ├── Favourites.css
│   │   ├── Home.css
│   │   └── index.css
│   ├── pages/                # Page components (Home, Favourites)
│   ├── services/             # API functions
│   ├── App.jsx               # Root component
│   ├── main.jsx              # Vite entry file
│
├── .env                      # API key (gitignored)
├── .gitignore
├── index.html
├── vite.config.js
├── package.json
└── README.md

🔧 API Setup

Make sure you’re using the correct API call format in services/api.js with the key accessed like this:

const API_KEY = import.meta.env.VITE_API_KEY;

🧪 Tech Stack

  • ⚛️ React (with Hooks & Context API)
  • ⚡ Vite
  • 🎨 CSS Modules
  • 📦 Fetch for API calls

🙌 Acknowledgements

  • Movie data provided by TMDB
  • Project inspired by modern movie apps and UIs

👨‍💻 Author

Kaviselvan SJ
GitHubLinkedIn

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors