Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/minhosong88/react-flickfinder
FlickFinder is a modern movie discovery app that helps you find top-rated movies with ease.
https://github.com/minhosong88/react-flickfinder
api movie-rating-app react-state-management reactjs
Last synced: 5 days ago
JSON representation
FlickFinder is a modern movie discovery app that helps you find top-rated movies with ease.
- Host: GitHub
- URL: https://github.com/minhosong88/react-flickfinder
- Owner: minhosong88
- Created: 2024-08-29T02:42:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-08-29T19:49:27.000Z (3 months ago)
- Last Synced: 2024-10-12T05:41:21.418Z (about 1 month ago)
- Topics: api, movie-rating-app, react-state-management, reactjs
- Language: JavaScript
- Homepage: https://minhosong88.github.io/react-flickfinder/
- Size: 735 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# FlickFinder
FlickFinder is a modern movie discovery app that helps you find top-rated movies with ease. Using the YTS API, FlickFinder displays the top 20 movie results based on a minimum rating threshold. Users can browse through the movies on the home page, click on a movie to view detailed information, and get a direct link to watch the movie.
## Live Demo
You can check out the live version of FlickFinder here: [FlickFinder Live Demo](https://minhosong88.github.io/react-flickfinder/)
## Features
- **Top-Rated Movies**: Displays the top 20 movies based on user-defined minimum rating.
- **Detailed Information**: Provides detailed information about each movie, including synopsis, genres, and year of release.
- **Direct Watch Links**: Direct links to watch the selected movies.
- **Dynamic Filtering**: Users can dynamically filter movies by adjusting the rating threshold.
## Technologies Used
- **React.js**: A JavaScript library for building user interfaces.
- **React Router**: For managing navigation and routing between different pages.
- **CSS**: Custom styling to achieve a sleek, Netflix-like interface.
- **YTS API**: For fetching movie data.
## Installation
To run FlickFinder locally, follow these steps:
1. **Clone the repository:**
```bash
git clone https://github.com/minhosong88/FlickFinder.git
```
2. **Navigate to the project directory:**
```bash
cd FlickFinder
```
3. **Install the dependencies:**
```bash
npm install
```
4. **Start the development server:**
```bash
npm start
```
5. **Open your browser and navigate to:**
```bash
http://localhost:3000
```
## Usage
- Adjust the rating slider on the home page to filter movies by minimum rating.
- Click on a movie card to view detailed information about the movie.
- Use the "Watch" button to open the movie's direct link for viewing.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request or open an issue for any suggestions or improvements.
## Contact
For any inquiries or support, please contact me at:
- **GitHub**: [minhosong88](https://github.com/minhosong88)
- **Email**: [[email protected]](mailto:[email protected])
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.