This is an app where users can discover new movies to watch. It is built with React using components from Ant Design.
The concept of this app is inspired by random movie roulette lists on Letterboxd. In their most basic usage, movie roulettes provide a convenient way of just choosing a movie to watch when decision fatigue strikes.
These lists also help film lovers expand their horizons by encouraging them to watch movies that they typically wouldn't watch. Streaming services can offer a lot of content that is difficult to discover organically because of the way that their algorithms push certain titles (and not others), leaving viewers in a rut. That's where movie roulettes come into play, too.
Random movie roulette lists typically work in the following way:
- Use a random number generator to pick a number.
- Search for the movie corresponding to that number on the list.
- You can skip a limited number of times, after which you should watch the movie discovered.
MovieRoulette aims at serving the same purposes from a single place.
- Randomized movie recommendations based on four categories.
- Possibility to skip recommendations indefinitely.
- Unique recommendations across categories.
- Filters to narrow down recommendations by cast, crew, year, language, runtime, similar movie, etc.
- Watchlist to keep track of accepted recommendations.
- List of rejected recommendations.
- Toggling between limited and indefinite recommendations.
- Full-fledged user accounts.
- Richer movie data drawn from additional APIs.
To run locally, make sure you have Node.js installed.
After cloning the repo, install the necessary packages inside the project directory:
$ npm install
Compile in development mode with npm start and you're good to go.
Contributions, issues, and feature requests are absolutely welcome. Take a look at the issues page before getting started.
Follow these steps to contribute:
- Fork the repo and
git clone <forked repo address>. - Create your working branch (
git checkout -b <descriptive-branch-name>). - Commit your changes (
git commit -am "<what this commit will fix/add>"). - Push to the branch (
git push origin <descriptive-branch-name>). - Open a pull request explaining your work.
Film data and images supplied by TMDb. This product uses the TMDb API but is not endorsed or certified by TMDb.
Icons made by Roundicons from www.flaticon.com.
See it live here.
MIT © 2020 Giuliana Ferraro
