# khalilandolsi/nextflix architecture

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

- Interactive diagram: https://gitdiagram.com/khalilandolsi/nextflix
- Repository: https://github.com/khalilandolsi/nextflix

## Overview

Nextflix is a Next.js streaming-discovery frontend: visitors browse TMDB movie and series catalogs, inspect title details, and play embedded video; signed-in users can search, manage a library, and review viewing history on their profile. The graph separates discovery, title/episode playback, account services, and library state. Several feature files are listed but not excerpted, so their connections are included only where the README documents them; the sampled source confirms the TMDB, search, season-fetch, and authentication wiring.

Main entry points: [`data/tmdb.ts`](https://github.com/khalilandolsi/nextflix/blob/main/data/tmdb.ts) (TMDB data layer), [`app/(root)/profile/page.tsx`](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/profile/page.tsx) (Profile page), [`lib/auth.ts`](https://github.com/khalilandolsi/nextflix/blob/main/lib/auth.ts) (Auth service), [`lib/prisma.ts`](https://github.com/khalilandolsi/nextflix/blob/main/lib/prisma.ts) (PostgreSQL via Prisma)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery and titles"]
  node_landing["Home discovery<br/>[page.tsx]"]
  node_movie_catalog["Movie catalog<br/>[page.tsx]"]
  node_series_catalog["Series catalog<br/>[page.tsx]"]
  node_movie_detail["Movie details<br/>[page.tsx]"]
  node_series_detail["Series details<br/>[page.tsx]"]
  node_tmdb_data["TMDB data layer<br/>[tmdb.ts]"]
  node_tmdb{{"TMDB API"}}
end

subgraph group_playback["Playback and search"]
  node_search_ui["Search overlay<br/>[search-overlay.tsx]"]
  node_search_api["Search route<br/>[route.ts]"]
  node_series_controller["Episode controller"]
  node_season_api["Season route<br/>[route.ts]"]
  node_player_gate["Playback gate<br/>[player-gate.tsx]"]
  node_embed{{"Embedded player"}}
end

subgraph group_accounts["Accounts"]
  node_auth_pages["Sign-in and sign-up<br/>[sign-in-form.tsx]"]
  node_auth_api["Auth route<br/>[route.ts]"]
  node_auth_service["Auth service<br/>[auth.ts]"]
  node_auth_store[("PostgreSQL via Prisma<br/>[prisma.ts]")]
  node_otp_email["OTP email sender<br/>[email.tsx]"]
  node_resend{{"Resend email"}}
end

subgraph group_library["Library and profile"]
  node_profile["Profile page<br/>[page.tsx]"]
  node_library_actions["Library actions<br/>[library-actions.ts]"]
  node_library_api["History route<br/>[route.ts]"]
  node_play_tracking["Play tracking<br/>[track-play.tsx]"]
end

node_viewer(("Viewer"))

node_viewer -->|"browses"| node_landing
node_viewer -->|"browses"| node_movie_catalog
node_viewer -->|"browses"| node_series_catalog
node_viewer -->|"opens title"| node_movie_detail
node_viewer -->|"opens title"| node_series_detail
node_landing -->|"loads discovery"| node_tmdb_data
node_movie_catalog -->|"loads listings"| node_tmdb_data
node_movie_detail -->|"loads details"| node_tmdb_data
node_series_detail -->|"loads details"| node_tmdb_data
node_tmdb_data -->|"requests catalog data"| node_tmdb
node_viewer -->|"searches"| node_search_ui
node_search_ui -->|"requests results"| node_search_api
node_search_api -->|"searches titles"| node_tmdb_data
node_series_controller -->|"fetches episodes"| node_season_api
node_season_api -->|"loads season"| node_tmdb_data
node_movie_detail -->|"gates playback"| node_player_gate
node_player_gate -->|"permits playback"| node_embed
node_series_detail -->|"renders episodes"| node_series_controller
node_viewer -->|"authenticates"| node_auth_pages
node_auth_pages -->|"submits credentials"| node_auth_api
node_auth_api -->|"dispatches auth"| node_auth_service
node_auth_service -->|"persists accounts"| node_auth_store
node_auth_service -->|"sends OTP"| node_otp_email
node_otp_email -->|"delivers email"| node_resend
node_viewer -->|"views library"| node_profile
node_profile -->|"checks session"| node_auth_service
node_profile -->|"reads library"| node_auth_store
node_profile -->|"resolves titles"| node_tmdb_data
node_viewer -->|"updates library"| node_library_actions
node_library_actions -->|"stores library state"| node_auth_store
node_play_tracking -->|"records plays"| node_library_actions
node_library_api -->|"reads history"| node_auth_store

click node_landing "https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/page.tsx"
click node_movie_catalog "https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/movies/page.tsx"
click node_series_catalog "https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/series/page.tsx"
click node_movie_detail "https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/movies/%5Bid%5D/page.tsx"
click node_series_detail "https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/series/%5Bid%5D/page.tsx"
click node_tmdb_data "https://github.com/khalilandolsi/nextflix/blob/main/data/tmdb.ts"
click node_search_ui "https://github.com/khalilandolsi/nextflix/blob/main/components/features/search-overlay.tsx"
click node_search_api "https://github.com/khalilandolsi/nextflix/blob/main/app/api/search/route.ts"
click node_series_controller "https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/series/_components/blocks/series-streaming-controller.tsx"
click node_season_api "https://github.com/khalilandolsi/nextflix/blob/main/app/api/streaming/serie/%5Bid%5D/season/route.ts"
click node_player_gate "https://github.com/khalilandolsi/nextflix/blob/main/components/features/player-gate.tsx"
click node_auth_pages "https://github.com/khalilandolsi/nextflix/blob/main/app/(auth)/_components/sign-in-form.tsx"
click node_auth_api "https://github.com/khalilandolsi/nextflix/blob/main/app/api/auth/%5B...all%5D/route.ts"
click node_auth_service "https://github.com/khalilandolsi/nextflix/blob/main/lib/auth.ts"
click node_auth_store "https://github.com/khalilandolsi/nextflix/blob/main/lib/prisma.ts"
click node_otp_email "https://github.com/khalilandolsi/nextflix/blob/main/lib/email.tsx"
click node_profile "https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/profile/page.tsx"
click node_library_actions "https://github.com/khalilandolsi/nextflix/blob/main/lib/library-actions.ts"
click node_library_api "https://github.com/khalilandolsi/nextflix/blob/main/app/api/library/history/route.ts"
click node_play_tracking "https://github.com/khalilandolsi/nextflix/blob/main/components/features/track-play.tsx"

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_landing,node_movie_catalog,node_series_catalog,node_movie_detail,node_series_detail,node_tmdb_data,node_tmdb,node_viewer toneBlue
class node_search_ui,node_search_api,node_series_controller,node_season_api,node_player_gate,node_embed toneAmber
class node_auth_pages,node_auth_api,node_auth_service,node_auth_store,node_otp_email,node_resend toneMint
class node_profile,node_library_actions,node_library_api,node_play_tracking toneRose
```

## Components

### Discovery and titles

- [Home discovery](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/page.tsx): `app/(root)/page.tsx`
- [Movie catalog](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/movies/page.tsx): `app/(root)/movies/page.tsx`
- [Series catalog](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/series/page.tsx): `app/(root)/series/page.tsx`
- [Movie details](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/movies/%5Bid%5D/page.tsx): `app/(root)/movies/[id]/page.tsx`
- [Series details](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/series/%5Bid%5D/page.tsx): `app/(root)/series/[id]/page.tsx`
- [TMDB data layer](https://github.com/khalilandolsi/nextflix/blob/main/data/tmdb.ts): `data/tmdb.ts`
- **TMDB API**

### Playback and search

- [Search overlay](https://github.com/khalilandolsi/nextflix/blob/main/components/features/search-overlay.tsx): `components/features/search-overlay.tsx`
- [Search route](https://github.com/khalilandolsi/nextflix/blob/main/app/api/search/route.ts): `app/api/search/route.ts`
- [Episode controller](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/series/_components/blocks/series-streaming-controller.tsx): `app/(root)/series/_components/blocks/series-streaming-controller.tsx`
- [Season route](https://github.com/khalilandolsi/nextflix/blob/main/app/api/streaming/serie/%5Bid%5D/season/route.ts): `app/api/streaming/serie/[id]/season/route.ts`
- [Playback gate](https://github.com/khalilandolsi/nextflix/blob/main/components/features/player-gate.tsx): `components/features/player-gate.tsx`
- **Embedded player**

### Accounts

- [Sign-in and sign-up](https://github.com/khalilandolsi/nextflix/blob/main/app/(auth)/_components/sign-in-form.tsx): `app/(auth)/_components/sign-in-form.tsx`
- [Auth route](https://github.com/khalilandolsi/nextflix/blob/main/app/api/auth/%5B...all%5D/route.ts): `app/api/auth/[...all]/route.ts`
- [Auth service](https://github.com/khalilandolsi/nextflix/blob/main/lib/auth.ts): `lib/auth.ts`
- [PostgreSQL via Prisma](https://github.com/khalilandolsi/nextflix/blob/main/lib/prisma.ts): `lib/prisma.ts`
- [OTP email sender](https://github.com/khalilandolsi/nextflix/blob/main/lib/email.tsx): `lib/email.tsx`
- **Resend email**

### Library and profile

- [Profile page](https://github.com/khalilandolsi/nextflix/blob/main/app/(root)/profile/page.tsx): `app/(root)/profile/page.tsx`
- [Library actions](https://github.com/khalilandolsi/nextflix/blob/main/lib/library-actions.ts): `lib/library-actions.ts`
- [History route](https://github.com/khalilandolsi/nextflix/blob/main/app/api/library/history/route.ts): `app/api/library/history/route.ts`
- [Play tracking](https://github.com/khalilandolsi/nextflix/blob/main/components/features/track-play.tsx): `components/features/track-play.tsx`

### Other components

- **Viewer**

## Connections

- Viewer → Home discovery: browses
- Viewer → Movie catalog: browses
- Viewer → Series catalog: browses
- Viewer → Movie details: opens title
- Viewer → Series details: opens title
- Home discovery → TMDB data layer: loads discovery (evidence: `app/(root)/page.tsx`)
- Movie catalog → TMDB data layer: loads listings (evidence: `app/(root)/movies/page.tsx`)
- Movie details → TMDB data layer: loads details (evidence: `app/(root)/movies/[id]/page.tsx`)
- Series details → TMDB data layer: loads details (evidence: `app/(root)/series/[id]/page.tsx`)
- TMDB data layer → TMDB API: requests catalog data
- Viewer → Search overlay: searches
- Search overlay → Search route: requests results
- Search route → TMDB data layer: searches titles (evidence: `app/api/search/route.ts`)
- Episode controller → Season route: fetches episodes (evidence: `app/(root)/series/_components/blocks/series-streaming-controller.tsx`)
- Season route → TMDB data layer: loads season (evidence: `app/api/streaming/serie/[id]/season/route.ts`)
- Movie details → Playback gate: gates playback (evidence: `app/(root)/movies/[id]/page.tsx`)
- Playback gate → Embedded player: permits playback
- Series details → Episode controller: renders episodes (evidence: `app/(root)/series/[id]/page.tsx`)
- Viewer → Sign-in and sign-up: authenticates
- Sign-in and sign-up → Auth route: submits credentials
- Auth route → Auth service: dispatches auth (evidence: `app/api/auth/[...all]/route.ts`)
- Auth service → PostgreSQL via Prisma: persists accounts (evidence: `lib/auth.ts`)
- Auth service → OTP email sender: sends OTP (evidence: `lib/auth.ts`)
- OTP email sender → Resend email: delivers email
- Viewer → Profile page: views library
- Profile page → Auth service: checks session (evidence: `app/(root)/profile/page.tsx`)
- Profile page → PostgreSQL via Prisma: reads library (evidence: `app/(root)/profile/page.tsx`)
- Profile page → TMDB data layer: resolves titles (evidence: `app/(root)/profile/page.tsx`)
- Viewer → Library actions: updates library
- Library actions → PostgreSQL via Prisma: stores library state
- Play tracking → Library actions: records plays (evidence: `components/features/track-play.tsx`)
- History route → PostgreSQL via Prisma: reads history (evidence: `app/api/library/history/route.ts`)
