FullStack Netflix Clone

A full-stack Netflix clone built with the MERN stack (MongoDB, Express.js, React, Node.js) that allows users to browse, search, and watch movies and TV shows.

Table of Contents

• Features
• Technologies Used
• Prerequisites
• Project Structure
• API Endpoints

Features

• User authentication (signup, login, logout)
• Browse trending movies and TV shows
• Search for movies and TV shows
• View detailed information about movies and TV shows
• Watch trailers and videos
• Responsive design for all device sizes
• User profile with avatar selection
• Search history tracking

Technologies Used

Frontend

• React 18
• React Router v7
• Tailwind CSS
• Zustand (State Management)
• Axios (HTTP Client)
• React Player (Video Playback)
• Lucide React (Icons)
• React Hot Toast (Notifications)

Backend

• Node.js
• Express.js
• MongoDB with Mongoose
• JSON Web Tokens (JWT) for authentication
• Bcrypt.js for password hashing
• TMDB API for movie/TV show data
• Cookie Parser for handling cookies

Prerequisites

Before you begin, ensure you have met the following requirements:

• Node.js >= 14.x
• MongoDB instance (local or cloud)
• TMDB API Key (get it from The Movie Database)

Project Structure

.
├── backend/
│   ├── config/          # Configuration files
│   ├── controllers/     # Request handlers
│   ├── middleware/      # Custom middleware
│   ├── models/          # Database models
│   ├── routes/          # API routes
│   ├── services/        # External services (TMDB API)
│   ├── utils/           # Utility functions
│   └── server.js        # Entry point
├── frontend/
│   ├── src/
│   │   ├── components/  # React components
│   │   ├── hooks/       # Custom hooks
│   │   ├── pages/       # Page components
│   │   ├── store/       # State management (Zustand)
│   │   ├── utils/       # Utility functions
│   │   ├── App.jsx      # Main App component
│   │   └── main.jsx     # Entry point
│   └── ...
├── .env.sample          # Environment variable template
├── package.json         # Backend dependencies
└── README.md

API Endpoints

Authentication

• POST /api/v1/auth/signup - User signup
• POST /api/v1/auth/login - User login
• POST /api/v1/auth/logout - User logout
• GET /api/v1/auth/authCheck - Check if user is authenticated

Movies

• GET /api/v1/movie/trending - Get trending movies
• GET /api/v1/movie/:id - Get movie details
• GET /api/v1/movie/:id/videos - Get movie videos
• GET /api/v1/movie/:id/similar - Get similar movies

TV Shows

• GET /api/v1/tv/trending - Get trending TV shows
• GET /api/v1/tv/:id - Get TV show details
• GET /api/v1/tv/:id/videos - Get TV show videos
• GET /api/v1/tv/:id/similar - Get similar TV shows

Search

• GET /api/v1/search/:query - Search for movies/TV shows
• GET /api/v1/search/history - Get user search history
• DELETE /api/v1/search/history - Clear user search history