Highlights

• Search by title, genre, actor, or director and view rich metadata at a glance.
• Build personalised watchlists and mark favorites across devices.
• Stream trailers, browse posters, and explore related recommendations in one place.

Favorites + Watchlist

Director Filmographies

Genre Discovery & Cast Deep-Dives

Tech Stack

• React + TypeScript UI with modular components.
• React Router for client-side navigation.
• Axios integration with TMDb for data and media.
• Tailwind CSS plus custom styles for a responsive layout.

Getting Started

1. Clone the repo

   git clone https://github.com/RJoshi141/cinemate.git
   cd cinemate/client

2. Install dependencies

   npm install

3. Configure API access
   • Create a .env file in client/.
   • Add your TMDb key:

     REACT_APP_TMDB_API_KEY=your_api_key_here

4. Run the app

   npm start

   Visit http://localhost:3000 to explore Cinemate.

Contributing

• Fork the project and create a feature branch.
• Keep commits scoped and descriptive.
• Submit a pull request with context and screenshots when relevant.

License

Released under the MIT License. See LICENSE for details.

Acknowledgments

• The Movie Database (TMDb) for powering data and imagery.
• The React and Tailwind CSS communities for their tooling and inspiration.

Thanks!

Enjoy, share it with friends, and keep chasing that next great story.