Skip to content

Oohnohassani/usePopcorn

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🍿 usePopcorn

A movie companion app built entirely with React Hooks that helps you discover, explore, rate, and keep track of movies you've watched.

React JavaScript Hooks Create React App Frontend Status

🎬 Overview

usePopcorn is a lightweight movie discovery and tracking application built entirely with React Hooks.

Search through a vast movie database, explore detailed movie information, rate films based on your personal taste, and maintain a curated watchlist of your favorite titles—all within a clean and intuitive interface.

The project focuses on modern React fundamentals and showcases practical usage of hooks for state management, side effects, and UI interactions.

✨ Features

  • 🔍 Instant movie search
  • 🎥 Detailed movie information and synopses
  • ⭐ Personal movie rating system
  • 📌 Save and manage your watchlist
  • ⚡ Fast and responsive React state updates
  • 🎯 Built entirely with React Hooks
  • 🧠 Demonstrates modern React patterns and best practices

🛠️ Built With

  • React
  • JavaScript (ES6+)
  • Create React App
  • React Hooks
    • useState
    • useEffect
    • useRef
    • Custom Hooks

🚀 Getting Started

Prerequisites

Make sure you have installed:

  • Node.js
  • npm

Installation

Clone the repository:

git clone https://github.com/Oohnohassani/usePopcorn.git

Navigate into the project directory:

cd usePopcorn

Install dependencies:

npm install

Start the development server:

npm run start

The application will be available at:

http://localhost:3000

📚 Learning Goals

This project was built to practice and demonstrate:

  • React component architecture
  • State management with Hooks
  • Side effects with useEffect
  • Reusable custom hooks
  • Component composition
  • API data fetching
  • Conditional rendering
  • Performance optimizations

⚠️ Current Limitations

This project is intentionally focused on frontend development and React fundamentals.

  • ❌ Not responsive
  • ❌ Not mobile-friendly
  • ❌ No backend/database
  • ❌ No user authentication
  • ❌ No persistent cloud storage

For now, ratings and watchlists exist only within the application's current state.

🔮 Future Improvements

Planned enhancements include:

  • 📱 Responsive design
  • 🌙 Dark mode
  • 🔐 User authentication
  • ☁️ Backend integration
  • 🗄️ Database persistence
  • 👥 User profiles
  • 🎯 Personalized recommendations

📸 Preview

Here is a screenchot of usePopcorn🍿 application

App Screenshot

🤝 Contributing

Contributions, suggestions, and improvements are welcome.

Feel free to fork the project and submit a pull request.

📄 License

This project is licensed under the MIT License.


Made with ❤️ and React Hooks 🍿

About

usePopcorn is a React-powered movie companion app built entirely with React Hooks. It lets you instantly search a vast movie database, dive into rich synopses to explore each film's plot, rate movies with your own personal score, and bookmark your favorites to build a curated watchlist — all in one seamless, hook-driven experience.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors