Skip to content

WatchReadList is a platform where users can discover and explore a wide range of content, including movies, TV shows, anime, manga, and books. Easily browse, search, and view detailed information about your favorite media in one place. Perfect for keeping track of what to watch, read, and enjoy next!

Notifications You must be signed in to change notification settings

Joyal-George-KJ/EpicLibrary

Repository files navigation

WatchReadList

WatchReadList is a versatile platform that allows users to explore and discover a wide variety of media content, including movies, TV shows, anime, manga, and books. The platform provides detailed information about these media types, making it easier to find new content to watch or read.

Features

  • Search Functionality: Search across multiple categories such as movies, TV shows, anime, manga, and books.
  • Detailed Information: Get detailed descriptions, ratings, and genre listings for each item.
  • Responsive Design: Enjoy a user-friendly interface across devices.
  • Personal Lists: Create and maintain lists of your favorite movies, anime, books, and more.
  • Genre Filtering: Filter content based on genre to discover new recommendations.

Technologies Used

  • React: Frontend library for building dynamic user interfaces.
  • React Router: For navigation and routing between different pages.
  • TailwindCSS: A utility-first CSS framework to style the platform.
  • APIs: Uses free APIs such as The Movie Database (TMDb) and Open Library API to fetch media data.

Installation

Prerequisites

Ensure that you have the following installed:

  • Node.js: Download from here.
  • npm: Comes with Node.js, ensure it's up-to-date.

Steps to Install:

  1. Clone the repository:
git clone https://github.com/Joyal-George-KJ/WatchReadList.git
  1. Navigate to the project directory:
cd WatchReadList
  1. Install the dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and visit:
http://localhost:3000

Usage

  1. Search Media:

    • Use the search bar to find movies, TV shows, anime, manga, and books by title.
  2. View Details:

    • Click on any media item to see its details, such as ratings, genres, and descriptions.
  3. Filter by Genre:

    • Filter the results by genre to explore different categories of media.

Code Structure

  • /src/components: Contains reusable UI components like search bars and media cards.
  • /src/pages: Contains page components for each media type (Movies, Anime, Books, etc.).
  • /src/utils: Utility functions and constants used for API interactions and data management.
  • /src/common: Common functions used for Configurations.

Contributing

Contributions are welcome! If you'd like to contribute to this project, feel free to fork the repository and submit a pull request.

Steps to Contribute:

  1. Fork the repository.
  2. Create your feature branch:
git checkout -b feature/my-feature
  1. Commit your changes:
git commit -m "Add some feature"
  1. Push to the branch:
git push origin feature/my-feature
  1. Open a pull request.

API Integration

WatchReadList uses the following APIs for fetching media data:

  • TMDb (The Movie Database): Used for movies and TV shows data.
  • Open Library API: For fetching book information.
  • Jikan API: For anime and manga data.

Improvements and Contributions Welcome

  1. Better UI/UX: Suggest design improvements.
  2. Auth Integration: Implement user authentication for personalized lists (e.g., using Firebase or Auth0).
  3. New Features: Propose and add new features such as watchlists, notifications, etc.

License

This project is open source and available under the MIT License.

Contact

For any queries or suggestions, feel free to reach out:


Contact Me 📱 || Socials in Profile 🌐 || Drop a Star ⭐!

About

WatchReadList is a platform where users can discover and explore a wide range of content, including movies, TV shows, anime, manga, and books. Easily browse, search, and view detailed information about your favorite media in one place. Perfect for keeping track of what to watch, read, and enjoy next!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published