An open API service indexing awesome lists of open source software.

https://github.com/chinxcode/movieflixx

Movieflix is an movie/ tvshow database plaform based on TMDB
https://github.com/chinxcode/movieflixx

api css database express html5 js movie movieflix node-js nodejs tmdb-api tv-shows

Last synced: 4 months ago
JSON representation

Movieflix is an movie/ tvshow database plaform based on TMDB

Awesome Lists containing this project

README

        

# 🎬 Movieflix - Your Ultimate Movie Database

## 🌟 Project Overview

Movieflix is a comprehensive web application designed for movie enthusiasts. It offers a rich, interactive platform for users to explore, discover, and manage their favorite movies and TV shows. With a sleek interface and powerful features, Movieflix brings the world of cinema to your fingertips.

## 🚀 Features

- **Home Page**: Showcases featured content and latest releases
- **Detailed Views**: In-depth information on movies and TV shows
- **Cast & Crew**: Explore the people behind the scenes
- **Genre Navigation**: Browse content by genres
- **Discovery Tool**: Find new and exciting content tailored to your tastes
- **Search Functionality**: Quickly find specific movies, shows, or people
- **Personal Watchlist**: Manage your must-watch list
- **Responsive Design**: Enjoy a seamless experience across all devices

## 💻 Technology Stack

- **Frontend**:
- HTML5
- CSS3 (with responsive design)
- JavaScript (ES6+)
- **Backend**:
- Node.js
- Express.js
- **View Engine**: EJS (Embedded JavaScript templating)
- **API**: TMDB

## 🛠 Setup and Installation

1. Clone the repository:

```
git clone https://github.com/chinxcode/movieflixx.git
```

2. Navigate to the project directory:

```
cd Movieflix
```

3. Install dependencies:

```
npm install
```

4. Start the server:

```
node server/server.js
```

5. Access the application at `http://localhost:3000` (or your specified port)

## 📘 Usage Guide

- **Home**: Start your journey on the home page to see featured content
- **Search**: Use the search bar to find specific movies or TV shows
- **Genres**: Explore content by selecting different genres
- **Discover**: Let our algorithm suggest new content based on your preferences
- **My List**: Add movies or shows to your personal watchlist for later viewing

## 🔗 API Reference

Our custom path for API (implemented in `api.js`) provides the following endpoints:

- `/api/movies`: Get a list of movies
- `/api/tvshows`: Get a list of TV shows
- `/api/search`: Search for content
- `/api/genres`: Get available genres
- `/api/person`: Get details about cast and crew

## 🤝 Contributing

We welcome contributions to Movieflix! Here's how you can help:

1. Fork the repository
2. Create your feature branch: `git checkout -b feature/AmazingFeature`
3. Commit your changes: `git commit -m 'Add some AmazingFeature'`
4. Push to the branch: `git push origin feature/AmazingFeature`
5. Open a pull request

---

Built with ❤️ by [@chinxcode](https://github.com/chinxcode)