Skip to content

Ofarouq310/filmpire

Repository files navigation


Project Banner
React Vite Tailwind CSS Redux MUI TMDB

🎬 Filmpire

Discover movies, explore genres, and find trending films powered by TMDB — beautifully crafted with React, Tailwind CSS, and Vite.


📋 Table of Contents

  1. 🤖 Introduction
  2. ⚙️ Tech Stack
  3. 🔋 Features
  4. 🚀 Performance
  5. 🤸 Quick Start
  6. 🔗 Links
  7. 💡 More

🤖 Introduction

Filmpire is a modern movie discovery web app built using React + Vite, powered by the TMDB API.
It provides an immersive interface for exploring trending movies, genres, and actors — with personalized features like favorites, watchlist, and detailed movie information.


⚙️ Tech Stack

  • ⚛️ React 18 – UI library for building fast interactive interfaces
  • Vite – Next-gen build tool with lightning-fast HMR
  • 🎨 Tailwind CSS – Utility-first CSS for responsive design
  • 🧠 Redux Toolkit – State management made simple
  • 💜 MUI – Ready-to-use components for accessible UI
  • 🎬 TMDB API – Source for movie data, genres, and trending lists

🔋 Features

  • 🔍 Smart Search: Instantly find movies, actors, or genres
  • 📺 Dynamic Recommendations: See similar movies based on what you view
  • ❤️ Favorites & Watchlist: Save your favorite films or track what to watch next
  • 📱 Fully Responsive: Works beautifully on mobile, tablet, and desktop
  • 🌙 Dark Mode Ready: Seamlessly adapts to your theme
  • 🧩 Reusable Components: Built with scalability and maintainability in mind
  • 🎞️ Detailed Movie Pages: View cast, trailers, ratings, and streaming providers
  • 🧭 Smooth Navigation: Built with React Router v6 for a modern SPA experience

🚀 Performance

Filmpire is optimized for speed and modern performance:

  • ⚙️ Code Splitting: Components and routes are dynamically loaded to reduce bundle size
  • 💤 Lazy Loading: Heavy content loads only when needed
  • 🧹 Optimized Images: Uses TMDB image sizes for reduced bandwidth
  • 📈 Measure with Google PageSpeed Insights:
    • Go to PageSpeed Insights
    • Enter your deployed site URL
    • Analyze Core Web Vitals and get performance improvement suggestions

You can also run Lighthouse in Chrome DevTools for local audits.


🤸 Quick Start

Follow these steps to set up the project locally 👇

Prerequisites

Make sure you have installed:

Clone the Repository

git clone https://github.com/Ofarouq310/filmpire.git
cd filmpire

🔗 Links

🌍 Live Demo: Filmpire on Vercel
💾 Repository: GitHub - Ofarouq310/filmpire


💡 More

💬 Built with creativity, precision, and love for cinema.


⭐ Follow for more modern and visually refined projects

About

Discover movies, explore genres, and find trending films powered by TMDB.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published