CUM - Couple's Ultimate Manager

CUM (Couple's Ultimate Manager) Couple’s Ultimate Manager: the ultimate tool for duos who do! 🎬💑 Make movie watchlists, track places you wanna visit, and keep tabs on all your shared dreams and schemes. Basically, it’s your relationship’s new BFF. ✨

Features

• Add Movies to Watchlist: Search for movies and add them to your personal or shared watchlist.
• Rate Movies: Rate movies that you've watched together and share your thoughts.
• Track Your Watch History: See which movies you've watched and their ratings.
• Couple’s Interaction: Rate and comment on movies together as a couple.

Getting Started

Prerequisites

Before you start, make sure you have the following installed:

• Node.js: To run the React development server.
• npm/yarn: To manage dependencies.

Installation

0. Go to couple-watching-frontend directory

1. Install dependencies:

   Using npm: npm install

2. Start the development server:

   Using npm: npm install

   The app should now be running at http://localhost:3000.

Usage

• Adding Movies: You can search for movies by name and add them to your watchlist by clicking the "Add to Watchlist" button.
• Rating Movies: Once you watch a movie together, you can rate it with a 1-10 star system and leave some thoughts.
• Viewing the Watchlist: Your watchlist will show all the movies you plan to watch next. You can easily filter and sort through it.
• Movie History: See which movies you've already rated and how you and your partner felt about them.

Technologies Used

• React.js (v18): The JavaScript library used for building the user interface.
• Material-UI (v6.3.1): For ready-to-use components that speed up UI development.
• React Router (v7.1.1): For navigation between different views such as Watchlist, Rated Movies, etc.
• React Query (v5.64.0): For fetching, caching, and syncing remote data in the app.
• Axios (v1.7.9): For making API calls to fetch movie data.
• React Hook Form (v7.54.2): For form handling in the app.
• Firebase (v11.2.0): For authentication and real-time database.
• Day.js (v1.11.13): For working with date and time.
• Lodash (v4.17.21): For utility functions to manipulate data and arrays.
• Motion (v11.18.0): For animations and transitions.
• React-Intl (v7.1.1): For internationalization and localization of the app.
• React Toastify (v11.0.3): For showing toast notifications.
• React Lazy Load Image Component (v1.6.3): For lazy-loading images to improve performance.
• Lottie-React (v2.4.1): For beautiful animated emojis.

Documentation

For more detailed documentation and technical information, please refer to the Technical Documentation. It's in Polish because it's easier to me to understand it, but hey - in 2025 we have all this fancy AI so I think you can translate that easily. :)

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgements

• Inspired by the idea of watching movies together and sharing opinions with your significant other!
• Movie data might is fetched from API OMDb API.

Feel free to contribute, share your thoughts, and make this app the ultimate couple movie companion!

Disclaimer: The name of this app is meant for fun. It is not intended to offend anyone. Also this is generated by ChatGPT cause rn I don't have time to do proper README.