# ayushm28114/animelist architecture

> Architecture diagram of the GitHub repository ayushm28114/animelist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayushm28114/animelist
- Repository: https://github.com/ayushm28114/animelist

## Overview

AnimeList is a full-stack anime catalog and community platform. Users browse and search Jikan-backed titles, inspect anime details, and use accounts to maintain status-based watchlists, share them, and write reviews. The frontend routes these workflows through service clients to Django REST endpoints; the backend serializes account and community data while persisting it in relational models and fetching catalog data from Jikan. The map reflects documented capabilities and shown imports/calls; several page and backend implementations were not sampled, so those links are omitted where call ownership is unverified.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/App.jsx) (Route shell), [`Frontend/src/services/animeService.js`](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/animeService.js) (Anime service), [`animelist/api/views.py`](https://github.com/ayushm28114/animelist/blob/main/animelist/api/views.py) (API handlers), [`Frontend/src/services/watchlistService.js`](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/watchlistService.js) (Watchlist service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React experience"]
  node_app["Route shell<br/>[App.jsx]"]
  node_auth["Accounts<br/>[AuthContext.jsx]"]
  node_search["Anime search<br/>[SearchPage.jsx]"]
  node_home["Discovery home<br/>[HomePage.jsx]"]
  node_details["Anime details"]
  node_reviews["Reviews<br/>[ReviewsSection.jsx]"]
  node_profile["Profile activity<br/>[ProfilePage.jsx]"]
  node_shared["Shared watchlist"]
end

subgraph group_frontend["Frontend services"]
  node_anime_service["Anime service<br/>[animeService.js]"]
  node_watch_service["Watchlist service"]
  node_api["Authenticated API<br/>[api.js]"]
  node_public_api["Public API<br/>[publicApi.js]"]
end

subgraph group_backend["Django API"]
  node_django["API routes<br/>[urls.py]"]
  node_views["API handlers<br/>[views.py]"]
  node_serializers["Serializers<br/>[serializers.py]"]
end

subgraph group_data["Domain data"]
  node_models[("Accounts and activity<br/>[models.py]")]
end

node_user(("Anime fan"))
node_jikan["Jikan catalog"]
node_database[("Relational database")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_search
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_details
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_shared
node_user -->|"signs in"| node_auth
node_auth -->|"requests tokens"| node_api
node_search -->|"searches through"| node_anime_service
node_details -.->|"loads title data"| node_anime_service
node_reviews -->|"manages reviews"| node_anime_service
node_profile -.->|"manages list"| node_watch_service
node_shared -.->|"loads shared list"| node_watch_service
node_anime_service -->|"requests catalog"| node_public_api
node_anime_service -->|"requests reviews"| node_api
node_watch_service -->|"requests private list"| node_api
node_watch_service -->|"requests shared list"| node_public_api
node_public_api -.->|"calls REST API"| node_django
node_api -.->|"calls REST API"| node_django
node_django -->|"routes to"| node_views
node_views -->|"serializes data"| node_serializers
node_views -->|"reads and writes"| node_models
node_serializers -->|"maps fields"| node_models
node_models -.->|"persists"| node_database
node_views -->|"fetches catalog"| node_jikan

click node_app "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/App.jsx"
click node_auth "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/context/AuthContext.jsx"
click node_search "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/SearchPage.jsx"
click node_home "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/HomePage.jsx"
click node_details "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/AnimeDetail/AnimeDetailPage.jsx"
click node_reviews "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/AnimeDetail/ReviewsSection.jsx"
click node_profile "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/ProfilePage.jsx"
click node_shared "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/SharedWatchlistPage.jsx"
click node_anime_service "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/animeService.js"
click node_watch_service "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/watchlistService.js"
click node_api "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/api.js"
click node_public_api "https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/publicApi.js"
click node_django "https://github.com/ayushm28114/animelist/blob/main/animelist/api/urls.py"
click node_views "https://github.com/ayushm28114/animelist/blob/main/animelist/api/views.py"
click node_serializers "https://github.com/ayushm28114/animelist/blob/main/animelist/api/serializers.py"
click node_models "https://github.com/ayushm28114/animelist/blob/main/animelist/api/models.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_search,node_home,node_details,node_reviews,node_profile,node_shared toneBlue
class node_anime_service,node_watch_service,node_api,node_public_api,node_database toneAmber
class node_django,node_views,node_serializers toneMint
class node_models toneRose
class node_user,node_jikan toneIndigo
```

## Components

### React experience

- [Route shell](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Accounts](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/context/AuthContext.jsx): `Frontend/src/context/AuthContext.jsx`
- [Anime search](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/SearchPage.jsx): `Frontend/src/pages/SearchPage.jsx`
- [Discovery home](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/HomePage.jsx): `Frontend/src/pages/HomePage.jsx`
- [Anime details](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/AnimeDetail/AnimeDetailPage.jsx): `Frontend/src/pages/AnimeDetail/AnimeDetailPage.jsx`
- [Reviews](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/AnimeDetail/ReviewsSection.jsx): `Frontend/src/pages/AnimeDetail/ReviewsSection.jsx`
- [Profile activity](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/ProfilePage.jsx): `Frontend/src/pages/ProfilePage.jsx`
- [Shared watchlist](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/pages/SharedWatchlistPage.jsx): `Frontend/src/pages/SharedWatchlistPage.jsx`

### Frontend services

- [Anime service](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/animeService.js): `Frontend/src/services/animeService.js`
- [Watchlist service](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/watchlistService.js): `Frontend/src/services/watchlistService.js`
- [Authenticated API](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/api.js): `Frontend/src/services/api.js`
- [Public API](https://github.com/ayushm28114/animelist/blob/main/Frontend/src/services/publicApi.js): `Frontend/src/services/publicApi.js`

### Django API

- [API routes](https://github.com/ayushm28114/animelist/blob/main/animelist/api/urls.py): `animelist/api/urls.py`
- [API handlers](https://github.com/ayushm28114/animelist/blob/main/animelist/api/views.py): `animelist/api/views.py`
- [Serializers](https://github.com/ayushm28114/animelist/blob/main/animelist/api/serializers.py): `animelist/api/serializers.py`

### Domain data

- [Accounts and activity](https://github.com/ayushm28114/animelist/blob/main/animelist/api/models.py): `animelist/api/models.py`

### Other components

- **Anime fan**
- **Jikan catalog**
- **Relational database**

## Connections

- Anime fan → Route shell: uses (evidence: `Frontend/src/App.jsx`)
- Route shell → Anime search: routes to (evidence: `Frontend/src/App.jsx`)
- Route shell → Discovery home: routes to (evidence: `Frontend/src/App.jsx`)
- Route shell → Anime details: routes to (evidence: `Frontend/src/App.jsx`)
- Route shell → Profile activity: routes to (evidence: `Frontend/src/App.jsx`)
- Route shell → Shared watchlist: routes to (evidence: `Frontend/src/App.jsx`)
- Anime fan → Accounts: signs in (evidence: `Frontend/src/context/AuthContext.jsx`)
- Accounts → Authenticated API: requests tokens (evidence: `Frontend/src/context/AuthContext.jsx`)
- Anime search → Anime service: searches through (evidence: `Frontend/src/pages/SearchPage.jsx`)
- Anime details → Anime service: loads title data
- Reviews → Anime service: manages reviews (evidence: `Frontend/src/pages/AnimeDetail/ReviewsSection.jsx`)
- Profile activity → Watchlist service: manages list (evidence: `Frontend/src/pages/ProfilePage.jsx`)
- Shared watchlist → Watchlist service: loads shared list
- Anime service → Public API: requests catalog (evidence: `Frontend/src/services/animeService.js`)
- Anime service → Authenticated API: requests reviews (evidence: `Frontend/src/services/animeService.js`)
- Watchlist service → Authenticated API: requests private list (evidence: `Frontend/src/services/watchlistService.js`)
- Watchlist service → Public API: requests shared list (evidence: `Frontend/src/services/watchlistService.js`)
- Public API → API routes: calls REST API
- Authenticated API → API routes: calls REST API
- API routes → API handlers: routes to (evidence: `animelist/api/urls.py`)
- API handlers → Serializers: serializes data (evidence: `animelist/api/views.py`)
- API handlers → Accounts and activity: reads and writes (evidence: `animelist/api/views.py`)
- Serializers → Accounts and activity: maps fields (evidence: `animelist/api/serializers.py`)
- Accounts and activity → Relational database: persists
- API handlers → Jikan catalog: fetches catalog (evidence: `animelist/api/views.py`)
