An open API service indexing awesome lists of open source software.

https://github.com/itzdineshx/anie_pick

Your next favorite Anime is just a click away
https://github.com/itzdineshx/anie_pick

anime anime-recommendation jikan-api recommendation-system

Last synced: 9 months ago
JSON representation

Your next favorite Anime is just a click away

Awesome Lists containing this project

README

          

# πŸ₯ AniePick

![AniePick Screenshot](./aniepick.png)

[![View Site](https://img.shields.io/badge/View_Live_Site-FF0000?style=for-the-badge&logo=netlify&logoColor=white)](https://aniepick.netlify.app/)

![Jikan API v4](https://img.shields.io/badge/Jikan%20API-v4-2E51A2?logo=myanimelist&logoColor=white&style=for-the-badge)
![API Status](https://img.shields.io/website?url=https%3A%2F%2Fapi.jikan.moe%2Fv4&label=Jikan%20API&color=2E51A2&style=for-the-badge)

AniePick is a red-and-black themed anime recommendation app powered by the **Jikan API** (MyAnimeList data).
It helps you discover random anime series or movies, with filters for genre, year, and more β€” no endless searching required.

---

## 🌟 Features

- 🎯 **Random Anime Discovery** – Get a completely new anime suggestion every time you visit.
- 🎨 **Anime-Themed UI** – Red & black color palette with Japanese-inspired fonts.
- πŸ“± **Responsive Design** – Optimized for desktop, tablet, and mobile.
- πŸ“„ **Detailed Info** – Title, synopsis, genres, episode count, score, and poster image.
- ❀️ **Favorites** – Save anime to your personal watchlist (local storage).
- πŸ” **Filtering** – Narrow results by genre, year, or type (TV, OVA, Movie, etc.).

---

## πŸ›  Tech Stack

- **Frontend:** HTML, CSS, JavaScript (React or Vanilla)
- **API:** [Jikan API](https://jikan.moe/)
- **Hosting:** Netlify / Vercel
- **Fonts:** [Kaushan Script](https://fonts.google.com/specimen/Kaushan+Script) for the logo, [Poppins](https://fonts.google.com/specimen/Poppins) for UI text.

---

## πŸ”‘ Setup Instructions

1. **Clone the repository**
```bash
git clone https://github.com/yourusername/Aniepick.git
cd Aniepick
````

2. **Install dependencies** (if using React)

```bash
npm install
```

3. **No API key required**

* AniePick uses the free **Jikan API**, so no signup is necessary.
* API Base URL: `https://api.jikan.moe/v4/`

4. **Run the app locally**

```bash
npm start
```

---

## πŸš€ Deployment

Deploy easily to [Netlify](https://www.netlify.com/) or [Vercel](https://vercel.com/).

---

## πŸ“œ License

This project is licensed under the MIT License.

---

## πŸ’‘ Acknowledgments

* **Jikan API** for anime data from MyAnimeList.
* **Google Fonts** for typography.
* **Brand Family** – AniePick is part of the β€œPick” brand alongside CinePick and MeloPick.

![AniePick Screenshot](./sugoipick-logo1.png)