Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/raiyashpramod/mm_client
Welcome to Movie Mania, a web application that lets users vote on their favorite movies and create battles between movies to determine which one is preferred by the community.
https://github.com/raiyashpramod/mm_client
framer-motion lucide-react reactjs styled-components tailwindcss tanstack-react-query typescript vite
Last synced: 2 days ago
JSON representation
Welcome to Movie Mania, a web application that lets users vote on their favorite movies and create battles between movies to determine which one is preferred by the community.
- Host: GitHub
- URL: https://github.com/raiyashpramod/mm_client
- Owner: RaiYashPramod
- Created: 2023-08-21T06:57:27.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-04T12:50:09.000Z (8 months ago)
- Last Synced: 2024-04-04T14:11:20.731Z (8 months ago)
- Topics: framer-motion, lucide-react, reactjs, styled-components, tailwindcss, tanstack-react-query, typescript, vite
- Language: TypeScript
- Homepage: https://cineclash.vercel.app
- Size: 2.3 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Movie Mania
Welcome to Movie Mania, a web application that lets users vote on their favorite movies and create battles between movies to determine which one is preferred by the community.
## Table of Contents
- [Introduction](#introduction)
- [Features](#features)
- [Getting Started](#getting-started)
- [Usage](#usage)
- [Future Enhancements](#future-enhancements)
- [Contributing](#contributing)
## Introduction
Movie Mania is a fun and interactive web application that allows movie enthusiasts to express their preferences among the latest movies. Users are presented with two randomly selected movies from a curated list of the latest releases. They can then choose their favorite movie from the two options. The chosen movie receives a +8 rating, while the other one receives a -8 rating.
Additionally, Movie Mania provides a feature for users to create movie battles. Users can select two movies, create a battle, and publish it on the site for other users to vote on. This enables users to see which movie is preferred by the community and why.
## Features
- Random movie matchups: Users are presented with two random movies from the latest releases.
- Voting system: Users can vote for their preferred movie, giving it a +8 rating, while the other movie receives a -8 rating.
- Movie battles: Users can create and publish battles between two movies, allowing the community to vote on their preferences.
- Battle insights: Users can view statistics and comments on movie battles to understand why certain movies are preferred.
## Getting Started
To get started with Movie Mania, follow these steps:
1. Clone the repository to your local machine:
```shell
git clone https://github.com/RaiYashPramod/movie-mania.git](https://github.com/RaiYashPramod/MM_Client.git)
```
2. Install the required dependencies:
```shell
cd movie-mania
npm install
```
3. Start the development server:
```shell
npm run dev
```
4. Access the web application in your browser at the link provided in the terminal.
## Usage
1. **Vote for Movies**:
- On the movie battle page, you will be presented with two random movie options.
- Click on your preferred movie to vote for it. The chosen movie receives a +8 rating, and the other movie receives a -8 rating.
2. **Create Movie Battles**:
- Navigate to the "Battles Royale" section of the application.
- Click on the "Create Battle" button.
- Select two movies that you want to create a battle for.
- Provide a title and optional description for the battle.
- Click "Publish" to create the battle.
3. **Vote on Battles**:
- Browse the list of published battles in the "Battles" section.
- Click on a battle to view details.
- Vote for your preferred movie in the battle.
4. **View Battle Insights**:
- See battle statistics, including the total number of votes and which movie is currently winning.
- Read comments from other users explaining their preferences.
## Future Enhancements
While Movie Mania is already an exciting platform for movie enthusiasts, there are several potential enhancements for the future:
- User profiles: Allow users to create profiles, track their voting history, and earn badges for active participation.
- Sorting and filtering: Implement sorting and filtering options for battles to help users discover interesting matchups.
- Comments and discussions: Enhance the comment system to facilitate discussions between users about movie preferences.
- Notifications: Notify users of new battles, comments, or when a movie they voted for wins a battle.
- User-generated content: Enable users to suggest movies to be added to the list of latest releases.
- Mobile apps: Develop mobile applications for a seamless movie voting experience on smartphones and tablets.
## Contributing
Contributions to Movie Mania are welcome! If you have ideas for improvements, bug fixes, or new features, feel free to open an issue or submit a pull request.
For questions, suggestions, or to discuss potential contributions, you can reach out to the project maintainers via email: [email protected]