🎬 Moviews

Moviews is a modern movie discovery web application built to explore popular films using The Movie Database (TMDB) API. It focuses on a clean cinematic UI, smooth transitions, and server-side data fetching to keep API keys secure.

---

✨ Features

• 🎞 Browse popular movies from TMDB
• 🔄 Auto-rotating hero slider with smooth transitions
• 🖱 Manual selection via interactive slider
• 🔐 Server-side API fetching (API key never exposed to client)
• ⚡ Built with performance and UX in mind

---

🛠 Tech Stack

• Framework: Next.js (App Router)
• Language: TypeScript
• Styling: Tailwind CSS
• Icons: Lucide React
• API: TMDB (The Movie Database)

---

🔑 TMDB API

This app uses the official TMDB API to fetch movie data.

• All requests are handled server-side
• API key is stored securely using environment variables

TMDB_API_KEY=your_api_key_here

---

🎨 Logo & Design

• The Moviews logo was generated using Google Gemini
• Additional design polish and creative touches were assisted by Antigravity

---

🚀 Getting Started

1. Clone the repository

git clone https://github.com/bangchand/moviews.git
cd moviews

2. Install dependencies

npm install
# or
bun install

3. Set up environment variables

Create a .env.local file:

TMDB_API_KEY=your_api_key_here

4. Run the development server

npm run dev
# or
bun dev

Open http://localhost:3000 in your browser.

---

📁 Project Status

• Core UI & movie browsing: ✅ Done

• Slider interactions & transitions: ✅ Done

• Future plans:

  • Movie detail pages
  • Search & filter
  • Favorites / watchlist

---

📜 Credits

• TMDB — for the amazing movie database
• Google Gemini — logo generation
• Antigravity — creative & development assistance

---

📄 License

This project is for educational and personal use. TMDB content is subject to TMDB terms of service.

---

Made with ❤️ for movies.