# edfwasd1234/feranimenative architecture

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

- Interactive diagram: https://gitdiagram.com/edfwasd1234/feranimenative
- Repository: https://github.com/edfwasd1234/feranimenative

## Overview

FerAnimeNative is primarily a native iOS anime and manga app backed by a Node resolver. The main user journey is browsing anime, matching a title to a streaming source, discovering episodes, resolving a stream, and watching it with native playback or an embed fallback; local progress and library state support resuming. Separate product branches cover manga reading and movies/TV metadata, plus Kodi library access. The README documents these capabilities, while sampled code confirms selected resolver routes and client calls; unsampled view wiring is not inferred.

Main entry points: [`backend/server.js`](https://github.com/edfwasd1234/feranimenative/blob/main/backend/server.js) (HTTP resolver), [`ios-native/FerAnimeNative/FerAnime/Networking/ResolverClient.swift`](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/ResolverClient.swift) (Resolver client), [`ios-native/FerAnimeNative/FerAnime/Views/AnimeDetailView.swift`](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/AnimeDetailView.swift) (Anime details), [`ios-native/FerAnimeNative/FerAnime/Views/PlayerView.swift`](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/PlayerView.swift) (Playback UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ios["Native iOS app"]
  node_native_shell["App shell<br/>[RootView.swift]"]
  node_app_state["App state<br/>[AppState.swift]"]
  node_anime_ui["Anime browsing<br/>[HomeView.swift]"]
  node_search_ui["Search<br/>[SearchView.swift]"]
  node_detail_ui["Anime details"]
  node_player_ui["Playback UI<br/>[PlayerView.swift]"]
  node_native_player["Native player"]
  node_embed_player["Embed fallback"]
  node_library_ui["Library<br/>[LibraryView.swift]"]
  node_manga_ui["Manga reader<br/>[MangaView.swift]"]
  node_media_ui["Movies and TV"]
  node_resolver_client["Resolver client"]
  node_jikan_client["Jikan client<br/>[JikanClient.swift]"]
  node_manga_client["Manga client"]
  node_stream_resolver["Stream resolver"]
  node_audio_session["Audio session<br/>[AudioSession.swift]"]
  node_notifications["Notifications"]
end

subgraph group_backend["Resolver backend"]
  node_resolver_server["HTTP resolver<br/>[server.js]"]
  node_anime_sources["Anime sources"]
  node_source_anigo["AniGo resolver<br/>[anigo.js]"]
  node_source_heaven["AnimeHeaven resolver<br/>[animeheaven.js]"]
  node_source_kai["AnimeKai resolver<br/>[animekai.js]"]
  node_source_zone["AniZone resolver<br/>[anizone.js]"]
  node_source_hianime["HiAnime resolver<br/>[hianime.js]"]
  node_source_wco["WCO resolver<br/>[wcotv.js]"]
  node_manga_scraper["Manga scraper<br/>[mangakatana.js]"]
  node_metadata["Anime metadata<br/>[metadata.js]"]
  node_tmdb["TMDB metadata<br/>[tmdb.js]"]
  node_kodi["Kodi library<br/>[kodi.js]"]
  node_media_embed["Media embeds<br/>[vsembed.js]"]
end

subgraph group_prototype["Expo reference app"]
end

subgraph group_services["Metadata and integrations"]
  node_jikan["Jikan API<br/>external service"]
  node_tmdb_service["TMDB API<br/>external service"]
end

node_viewer(("Viewer"))

node_viewer -->|"uses"| node_native_shell
node_anime_ui -.->|"requests catalog"| node_resolver_client
node_search_ui -.->|"searches sources"| node_resolver_client
node_detail_ui -.->|"loads episodes"| node_resolver_client
node_detail_ui -.->|"matches metadata"| node_jikan_client
node_resolver_client -->|"calls API"| node_resolver_server
node_player_ui -.->|"plays streams"| node_native_player
node_player_ui -.->|"falls back"| node_embed_player
node_player_ui -.->|"uses session"| node_audio_session
node_detail_ui -.->|"matches sources"| node_stream_resolver
node_library_ui -.->|"reads saved state"| node_app_state
node_manga_ui -.->|"loads manga"| node_manga_client
node_media_ui -->|"requests media"| node_resolver_client
node_media_ui -.->|"uses embed"| node_embed_player
node_app_state -->|"holds client"| node_resolver_client
node_app_state -->|"uses notifications"| node_notifications
node_resolver_server -->|"dispatches"| node_source_kai
node_resolver_server -->|"dispatches"| node_source_zone
node_resolver_server -->|"dispatches"| node_source_heaven
node_resolver_server -->|"dispatches"| node_source_hianime
node_resolver_server -->|"dispatches"| node_source_anigo
node_resolver_server -->|"routes to"| node_source_wco
node_resolver_server -->|"routes to"| node_manga_scraper
node_resolver_server -->|"routes to"| node_metadata
node_resolver_server -->|"routes to"| node_tmdb
node_resolver_server -->|"routes to"| node_kodi
node_resolver_server -->|"routes to"| node_media_embed
node_manga_client -.->|"calls manga API"| node_resolver_server
node_jikan_client -.->|"fetches metadata"| node_jikan
node_tmdb -.->|"fetches metadata"| node_tmdb_service

click node_native_shell "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/App/RootView.swift"
click node_app_state "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/App/AppState.swift"
click node_anime_ui "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/HomeView.swift"
click node_search_ui "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/SearchView.swift"
click node_detail_ui "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/AnimeDetailView.swift"
click node_player_ui "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/PlayerView.swift"
click node_native_player "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Playback/NativeVideoPlayerView.swift"
click node_embed_player "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Playback/WebEmbedPlayerView.swift"
click node_library_ui "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/LibraryView.swift"
click node_manga_ui "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/MangaView.swift"
click node_media_ui "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/MediaExploreView.swift"
click node_resolver_client "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/ResolverClient.swift"
click node_jikan_client "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/JikanClient.swift"
click node_manga_client "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/MangaKatanaClient.swift"
click node_stream_resolver "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/StreamResolver.swift"
click node_audio_session "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Playback/AudioSession.swift"
click node_notifications "https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/App/NotificationManager.swift"
click node_resolver_server "https://github.com/edfwasd1234/feranimenative/blob/main/backend/server.js"
click node_anime_sources "https://github.com/edfwasd1234/feranimenative/tree/main/backend"
click node_source_anigo "https://github.com/edfwasd1234/feranimenative/blob/main/backend/anigo.js"
click node_source_heaven "https://github.com/edfwasd1234/feranimenative/blob/main/backend/animeheaven.js"
click node_source_kai "https://github.com/edfwasd1234/feranimenative/blob/main/backend/animekai.js"
click node_source_zone "https://github.com/edfwasd1234/feranimenative/blob/main/backend/anizone.js"
click node_source_hianime "https://github.com/edfwasd1234/feranimenative/blob/main/backend/hianime.js"
click node_source_wco "https://github.com/edfwasd1234/feranimenative/blob/main/backend/wcotv.js"
click node_manga_scraper "https://github.com/edfwasd1234/feranimenative/blob/main/backend/mangakatana.js"
click node_metadata "https://github.com/edfwasd1234/feranimenative/blob/main/backend/metadata.js"
click node_tmdb "https://github.com/edfwasd1234/feranimenative/blob/main/backend/tmdb.js"
click node_kodi "https://github.com/edfwasd1234/feranimenative/blob/main/backend/kodi.js"
click node_media_embed "https://github.com/edfwasd1234/feranimenative/blob/main/backend/vsembed.js"

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_native_shell,node_app_state,node_anime_ui,node_search_ui,node_detail_ui,node_player_ui,node_native_player,node_embed_player,node_library_ui,node_manga_ui,node_media_ui,node_resolver_client,node_jikan_client,node_manga_client,node_stream_resolver,node_audio_session,node_notifications,node_viewer toneBlue
class node_resolver_server,node_anime_sources,node_source_anigo,node_source_heaven,node_source_kai,node_source_zone,node_source_hianime,node_source_wco,node_manga_scraper,node_metadata,node_tmdb,node_kodi,node_media_embed toneAmber
class node_jikan,node_tmdb_service toneRose
```

## Components

### Native iOS app

- [App shell](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/App/RootView.swift): `ios-native/FerAnimeNative/FerAnime/App/RootView.swift`
- [App state](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/App/AppState.swift): `ios-native/FerAnimeNative/FerAnime/App/AppState.swift`
- [Anime browsing](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/HomeView.swift): `ios-native/FerAnimeNative/FerAnime/Views/HomeView.swift`
- [Search](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/SearchView.swift): `ios-native/FerAnimeNative/FerAnime/Views/SearchView.swift`
- [Anime details](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/AnimeDetailView.swift): `ios-native/FerAnimeNative/FerAnime/Views/AnimeDetailView.swift`
- [Playback UI](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/PlayerView.swift): `ios-native/FerAnimeNative/FerAnime/Views/PlayerView.swift`
- [Native player](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Playback/NativeVideoPlayerView.swift): `ios-native/FerAnimeNative/FerAnime/Playback/NativeVideoPlayerView.swift`
- [Embed fallback](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Playback/WebEmbedPlayerView.swift): `ios-native/FerAnimeNative/FerAnime/Playback/WebEmbedPlayerView.swift`
- [Library](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/LibraryView.swift): `ios-native/FerAnimeNative/FerAnime/Views/LibraryView.swift`
- [Manga reader](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/MangaView.swift): `ios-native/FerAnimeNative/FerAnime/Views/MangaView.swift`
- [Movies and TV](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Views/MediaExploreView.swift): `ios-native/FerAnimeNative/FerAnime/Views/MediaExploreView.swift`
- [Resolver client](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/ResolverClient.swift): `ios-native/FerAnimeNative/FerAnime/Networking/ResolverClient.swift`
- [Jikan client](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/JikanClient.swift): `ios-native/FerAnimeNative/FerAnime/Networking/JikanClient.swift`
- [Manga client](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/MangaKatanaClient.swift): `ios-native/FerAnimeNative/FerAnime/Networking/MangaKatanaClient.swift`
- [Stream resolver](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Networking/StreamResolver.swift): `ios-native/FerAnimeNative/FerAnime/Networking/StreamResolver.swift`
- [Audio session](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/Playback/AudioSession.swift): `ios-native/FerAnimeNative/FerAnime/Playback/AudioSession.swift`
- [Notifications](https://github.com/edfwasd1234/feranimenative/blob/main/ios-native/FerAnimeNative/FerAnime/App/NotificationManager.swift): `ios-native/FerAnimeNative/FerAnime/App/NotificationManager.swift`

### Resolver backend

- [HTTP resolver](https://github.com/edfwasd1234/feranimenative/blob/main/backend/server.js): `backend/server.js`
- [Anime sources](https://github.com/edfwasd1234/feranimenative/tree/main/backend): `backend`
- [AniGo resolver](https://github.com/edfwasd1234/feranimenative/blob/main/backend/anigo.js): `backend/anigo.js`
- [AnimeHeaven resolver](https://github.com/edfwasd1234/feranimenative/blob/main/backend/animeheaven.js): `backend/animeheaven.js`
- [AnimeKai resolver](https://github.com/edfwasd1234/feranimenative/blob/main/backend/animekai.js): `backend/animekai.js`
- [AniZone resolver](https://github.com/edfwasd1234/feranimenative/blob/main/backend/anizone.js): `backend/anizone.js`
- [HiAnime resolver](https://github.com/edfwasd1234/feranimenative/blob/main/backend/hianime.js): `backend/hianime.js`
- [WCO resolver](https://github.com/edfwasd1234/feranimenative/blob/main/backend/wcotv.js): `backend/wcotv.js`
- [Manga scraper](https://github.com/edfwasd1234/feranimenative/blob/main/backend/mangakatana.js): `backend/mangakatana.js`
- [Anime metadata](https://github.com/edfwasd1234/feranimenative/blob/main/backend/metadata.js): `backend/metadata.js`
- [TMDB metadata](https://github.com/edfwasd1234/feranimenative/blob/main/backend/tmdb.js): `backend/tmdb.js`
- [Kodi library](https://github.com/edfwasd1234/feranimenative/blob/main/backend/kodi.js): `backend/kodi.js`
- [Media embeds](https://github.com/edfwasd1234/feranimenative/blob/main/backend/vsembed.js): `backend/vsembed.js`

### Metadata and integrations

- **Jikan API**: external service
- **TMDB API**: external service

### Other components

- **Viewer**

## Connections

- Viewer → App shell: uses (evidence: `README.md`)
- Anime browsing → Resolver client: requests catalog
- Search → Resolver client: searches sources
- Anime details → Resolver client: loads episodes
- Anime details → Jikan client: matches metadata (evidence: `README.md`)
- Resolver client → HTTP resolver: calls API (evidence: `ios-native/FerAnimeNative/FerAnime/Networking/ResolverClient.swift`)
- Playback UI → Native player: plays streams (evidence: `README.md`)
- Playback UI → Embed fallback: falls back (evidence: `README.md`)
- Playback UI → Audio session: uses session (evidence: `README.md`)
- Anime details → Stream resolver: matches sources (evidence: `README.md`)
- Library → App state: reads saved state
- Manga reader → Manga client: loads manga (evidence: `README.md`)
- Movies and TV → Resolver client: requests media (evidence: `ios-native/FerAnimeNative/FerAnime/Views/MediaExploreView.swift`)
- Movies and TV → Embed fallback: uses embed (evidence: `README.md`)
- App state → Resolver client: holds client (evidence: `ios-native/FerAnimeNative/FerAnime/App/AppState.swift`)
- App state → Notifications: uses notifications (evidence: `ios-native/FerAnimeNative/FerAnime/App/AppState.swift`)
- HTTP resolver → AnimeKai resolver: dispatches (evidence: `backend/server.js`)
- HTTP resolver → AniZone resolver: dispatches (evidence: `backend/server.js`)
- HTTP resolver → AnimeHeaven resolver: dispatches (evidence: `backend/server.js`)
- HTTP resolver → HiAnime resolver: dispatches (evidence: `backend/server.js`)
- HTTP resolver → AniGo resolver: dispatches (evidence: `backend/server.js`)
- HTTP resolver → WCO resolver: routes to (evidence: `backend/server.js`)
- HTTP resolver → Manga scraper: routes to (evidence: `backend/server.js`)
- HTTP resolver → Anime metadata: routes to (evidence: `backend/server.js`)
- HTTP resolver → TMDB metadata: routes to (evidence: `backend/server.js`)
- HTTP resolver → Kodi library: routes to (evidence: `backend/server.js`)
- HTTP resolver → Media embeds: routes to (evidence: `backend/server.js`)
- Manga client → HTTP resolver: calls manga API (evidence: `README.md`)
- Jikan client → Jikan API: fetches metadata (evidence: `README.md`)
- TMDB metadata → TMDB API: fetches metadata (evidence: `README.md`)
