Skip to content

mulayharshal/Movie-Explorer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎬 Movie Explorer

A Modern & Fast Movie Search Platform (React + Spring Boot)

React Vite Java Spring Boot OMDB API

πŸ”— Live Frontend: https://movieexplorersapp.netlify.app/

πŸ”— Backend API: https://movie-explorer-kz6z.onrender.com/

πŸ”— GitHub Repo: https://github.com/mulayharshal/Movie-Explorer.git


πŸ† Overview

Movie Explorer is a full-stack movie browsing platform that provides a smooth and responsive experience for discovering movies, series, and episodes.

Users can:

  • πŸ”Ž Search movies by title
  • 🎬 View full movie details
  • ⭐ Check ratings (IMDb, Rotten Tomatoes, Metacritic)
  • πŸ“± Use on any device (fully responsive)
  • ⚑ Enjoy fast performance through smart caching
  • πŸ’Ύ Automatically restore the last search

πŸ› οΈ Backend (Web Service API)

The backend is developed with Spring Boot and provides a clean REST API layer between the frontend and the OMDB API.

βœ” Features

  • πŸ›° RESTful endpoints for search & movie details
  • πŸ” Secure API key handling using environment variables
  • ⚑ In-memory caching
    • Cache expiry
    • Max size limit
  • πŸš€ Fast HTTP client using RestTemplate
  • 🧹 Error handling (invalid title, no results, API failure)
  • πŸ— Extensible architecture for future expansion

βœ” API Endpoints

πŸ” Search Movie

GET /api/movies/search?title=Iron Man

🎬 Movie Details

GET /api/movies/details?id=tt0371746

🎨 Frontend (UI Layer)

Built using React + Vite with clean, modern, responsive design.

βœ” Features

  • πŸ”Ž Search dashboard with instant results
  • 🎞 Grid layout of movies (poster, title, year, type)
  • 🎬 Detailed movie page
    • Poster
    • Director
    • Genre
    • Plot
    • Actors
    • Ratings list
  • πŸ’Ύ Last search auto-restored (localStorage)
  • 🟦 Beautiful movie cards (9:16 poster ratio)
  • 🧩 Easy navigation with React Router
  • πŸ“± Fully responsive for all devices
  • 🎨 Polished UI for production use

🧰 Tech Stack

Frontend Backend API Source Deployment
βš›οΈ React (Vite) β˜• Spring Boot πŸŽ₯ OMDB API 🌐 Netlify (Frontend)
🎨 CSS πŸ”§ RestTemplate ☁ Render (Backend)

πŸš€ Getting Started

1️⃣ Clone the repository

git clone https://github.com/mulayharshal/Movie-Explorer.git
cd movie-explorer

🟦 Frontend Setup (React + Vite)

cd frontend-movie-explorer
npm install
npm run dev

Runs at:

http://localhost:5173/

Create .env:

VITE_API_URL=http://localhost:8080/api
VITE_WEBSITE_NAME=Movie Explorer

🟩 Backend Setup (Spring Boot)

cd backend-movie-explorer
mvn spring-boot:run

Set your API key:

OMDB_API_KEY=your_api_key_here

Backend runs at:

http://localhost:8080

πŸ“Έ Screenshots

πŸ” Search Page

Search Page

🎬 Movie Details

Details Page

πŸ“± Mobile Responsive

Mobile View


πŸ‘¨β€πŸ’» Developer
Harshal Mulay
πŸ“ India
πŸ”— GitHub: https://github.com/mulayharshal

⭐ If you like this project, please give the repository a star!

About

A full-stack Movie Explorer app using React (Vite) and Spring Boot with OMDB API integration. Includes movie search, detailed movie info, in-memory caching for performance, error handling, and a responsive UI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors