Skip to content

ibayjimwell/moviary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎬 Moviary

Your Personal Movie Diary — Anytime, Anywhere

Moviary App

🌐 Live Demo: https://moviary.vercel.app/ 🔥 Trending API (Custom Backend): https://github.com/ibayjimwell/moviary-trending-api


📖 Overview

Moviary is a modern movie browsing web app where users can:

  • Search for movies
  • Explore popular titles
  • Discover trending films

It connects to The Movie Database (TMDB) API and a custom Trending Handler API to deliver real-time movie data in a clean and fast interface.


🚀 Key Features

🔍 Movie Search

Quickly search for any movie by title and get instant results.

📈 Trending Movies

Displays trending movies using a custom backend API that tracks popularity.

⭐ Popular Movies

Browse currently popular movies based on live TMDB data.

⚡ Fast & Responsive

Optimized UI for smooth browsing and quick API responses.

🎨 Clean UI

Modern layout built for easy navigation and a great user experience.


⚙️ How Moviary Works

Moviary fetches movie data from:

  • 🎥 TMDB (The Movie Database) API — movie details, posters, popularity
  • 🔥 Moviary Trending Handler API — custom backend to manage trending logic

TMDB is a free movie database API. Learn more at: 👉 https://www.themoviedb.org/


🧠 Use Cases

  • Discover movies you’ve never watched
  • Find trending titles people are currently into
  • Explore popular films before movie night
  • Quickly search details about any movie

💻 Tech Stack

React TailwindCSS TMDB API


🛠 Running Locally

1️⃣ Clone the repository

git clone https://github.com/ibayjimwell/moviary.git
cd moviary

2️⃣ Install dependencies

npm install

3️⃣ Setup Environment Variables

Create a .env file:

VITE_TMDB_API_KEY=your_tmdb_api_key
VITE_TRENDING_API_URL=your_trending_api_url

4️⃣ Start the development server

npm run dev

🤝 Contributing

Contributions are welcome!

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a Pull Request

📌 Future Improvements

  • User watchlist feature
  • Movie rating system
  • Genre filters
  • Movie detail page
  • Authentication system

👨‍💻 Author

Jimwell Ibay Creator & Maintainer

About

Your personal movie diary, anytime, anywhere.

Topics

Resources

Stars

Watchers

Forks

Contributors