https://github.com/itzdineshx/cine_pick

Your next favorite film is just a click away
https://github.com/itzdineshx/cine_pick

api cinema movie-recommendation-app recommendation-system tmdb-api

Last synced: 13 days ago
JSON representation

Your next favorite film is just a click away

• Host: GitHub
• URL: https://github.com/itzdineshx/cine_pick
• Owner: itzdineshx
• License: mit
• Created: 2025-08-14T05:56:58.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2025-10-03T15:44:03.000Z (14 days ago)
• Last Synced: 2025-10-03T17:52:43.151Z (14 days ago)
• Topics: api, cinema, movie-recommendation-app, recommendation-system, tmdb-api
• Language: TypeScript
• Homepage: https://cinempick.netlify.app/
• Size: 862 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🎬 CinePick

![CinePick Screenshot](./cinepick.png)



[![View Site](https://img.shields.io/badge/View_Live_Site-D19D00?style=for-the-badge&logo=netlify&logoColor=white)](https://cinempick.netlify.app/)

![IMDb API](https://img.shields.io/badge/IMDb-API-F5C518?logo=imdb&logoColor=black&labelColor=1B1F23&style=flat-square)

![API Status](https://img.shields.io/website?url=https%3A%2F%2Fimdb-api.com&label=IMDb%20API&style=flat-square)



CinePick is a yellow-and-black themed movie recommendation app powered by **The Movie Database (TMDb) API**.  

Say goodbye to endlessly browsing through lists — CinePick finds great movies for you with a single click.

---

## 🌟 Features

- 🎥 **Random Movie Discovery** – Find a surprise movie every time you visit.

- 🎨 **Cinematic UI** – Sleek black & yellow theme with clean typography.

- 📱 **Responsive** – Works perfectly on desktop, tablet, and mobile.

- 📄 **Detailed Info** – View poster, description, genres, runtime, ratings, and release date.

- ❤️ **Favorites** – Save movies you love to watch later.

- 🔍 **Filtering** – Filter by genre, year, or rating.

---

## 🛠 Tech Stack

- **Frontend:** HTML, CSS, JavaScript (React or Vanilla)

- **API:** [TMDb API](https://developer.themoviedb.org/)

- **Hosting:** Netlify / Vercel

- **Fonts:** [Bebas Neue](https://fonts.google.com/specimen/Bebas+Neue) for headings, [Poppins](https://fonts.google.com/specimen/Poppins) for UI.

---

## 🔑 Setup Instructions

1. **Clone the repository**

   ```bash

   git clone https://github.com/yourusername/cinepick.git

   cd cinepick

   ````

2. **Install dependencies** (if using React)

   ```bash

   npm install

   ```

3. **Get TMDb API Key**

   * Sign up at [The Movie Database](https://www.themoviedb.org/)

   * Go to settings → API → Generate key

   * Example:

     * `API Key` → `ef--------------57`

     * `Bearer Token` → `ey--------------3Y...`

4. **Create `.env` file**

   ```env

   REACT_APP_TMDB_API_KEY=ef----------------------57

   REACT_APP_TMDB_BEARER=ey----------------------------So

   ```

5. **Run the app locally**

   ```bash

   npm start

   ```

---

## 🚀 Deployment

Deploy easily to [Netlify](https://www.netlify.com/) or [Vercel](https://vercel.com/).

---

## 📜 License

This project is licensed under the MIT License.

---

## 💡 Acknowledgments

* **TMDb API** for movie data and posters.

* **Google Fonts** for typography.

* **Brand Family** – CinePick is part of the “Pick” brand alongside AniePick and MeloPick.

![CinePick Screenshot](./cinepick-logo2.png)