# mahmuda1240/movie-explorer architecture

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

- Interactive diagram: https://gitdiagram.com/mahmuda1240/movie-explorer
- Repository: https://github.com/mahmuda1240/movie-explorer

## Overview

Reelist is a React show-discovery app: visitors enter through the home page or browse route, where the browse page loads shows and searches by title, then lets visitors open show details in a modal. The internal layers are route composition, page-level state and orchestration, reusable presentation components, and a TVMaze API client. The README documents the search and empty-query behavior; the sampled source shows the API calls and page wiring. The home page’s loaded picks are not rendered in the excerpt, so that path is not expanded.

Main entry points: [`src/pages/Movies.jsx`](https://github.com/mahmuda1240/movie-explorer/blob/main/src/pages/Movies.jsx) (Browse Page), [`src/api/tvmaze.js`](https://github.com/mahmuda1240/movie-explorer/blob/main/src/api/tvmaze.js) (TVMaze Client), [`src/App.jsx`](https://github.com/mahmuda1240/movie-explorer/blob/main/src/App.jsx) (Route Shell), [`src/pages/Home.jsx`](https://github.com/mahmuda1240/movie-explorer/blob/main/src/pages/Home.jsx) (Home Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App Routing"]
  node_entry["React Entry<br/>[main.jsx]"]
  node_app["Route Shell<br/>[App.jsx]"]
end

subgraph group_discovery["Show Discovery"]
  node_home["Home Page<br/>[Home.jsx]"]
  node_movies["Browse Page<br/>[Movies.jsx]"]
end

subgraph group_presentation["Presentation"]
  node_navbar["Navigation Bar<br/>[Navbar.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
  node_hero["Home Hero<br/>[Hero.jsx]"]
  node_search["Show Search<br/>[SearchBar.jsx]"]
  node_card["Show Card<br/>[MovieCard.jsx]"]
  node_modal["Show Details<br/>[MovieModal.jsx]"]
end

subgraph group_integration["API Integration"]
  node_client["TVMaze Client<br/>[tvmaze.js]"]
end

node_visitor(("Visitor"))
node_tvmaze["TVMaze API"]

node_visitor -->|"opens app"| node_entry
node_entry -->|"renders"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_footer
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_movies
node_home -->|"renders"| node_hero
node_home -->|"loads shows"| node_client
node_movies -->|"loads shows"| node_client
node_movies -->|"searches shows"| node_client
node_movies -->|"renders"| node_search
node_movies -->|"renders"| node_card
node_movies -->|"renders"| node_modal
node_modal -->|"formats details"| node_client
node_card -->|"formats show data"| node_client
node_client -->|"requests shows"| node_tvmaze

click node_entry "https://github.com/mahmuda1240/movie-explorer/blob/main/src/main.jsx"
click node_app "https://github.com/mahmuda1240/movie-explorer/blob/main/src/App.jsx"
click node_navbar "https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/Navbar.jsx"
click node_footer "https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/Footer.jsx"
click node_home "https://github.com/mahmuda1240/movie-explorer/blob/main/src/pages/Home.jsx"
click node_hero "https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/Hero.jsx"
click node_movies "https://github.com/mahmuda1240/movie-explorer/blob/main/src/pages/Movies.jsx"
click node_search "https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/SearchBar.jsx"
click node_card "https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/MovieCard.jsx"
click node_modal "https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/MovieModal.jsx"
click node_client "https://github.com/mahmuda1240/movie-explorer/blob/main/src/api/tvmaze.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_entry,node_app toneBlue
class node_home,node_movies toneAmber
class node_navbar,node_footer,node_hero,node_search,node_card,node_modal,node_tvmaze toneMint
class node_client toneRose
class node_visitor toneIndigo
```

## Components

### App Routing

- [React Entry](https://github.com/mahmuda1240/movie-explorer/blob/main/src/main.jsx): `src/main.jsx`
- [Route Shell](https://github.com/mahmuda1240/movie-explorer/blob/main/src/App.jsx): `src/App.jsx`

### Show Discovery

- [Home Page](https://github.com/mahmuda1240/movie-explorer/blob/main/src/pages/Home.jsx): `src/pages/Home.jsx`
- [Browse Page](https://github.com/mahmuda1240/movie-explorer/blob/main/src/pages/Movies.jsx): `src/pages/Movies.jsx`

### Presentation

- [Navigation Bar](https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Footer](https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/Footer.jsx): `src/components/Footer.jsx`
- [Home Hero](https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/Hero.jsx): `src/components/Hero.jsx`
- [Show Search](https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/SearchBar.jsx): `src/components/SearchBar.jsx`
- [Show Card](https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/MovieCard.jsx): `src/components/MovieCard.jsx`
- [Show Details](https://github.com/mahmuda1240/movie-explorer/blob/main/src/components/MovieModal.jsx): `src/components/MovieModal.jsx`

### API Integration

- [TVMaze Client](https://github.com/mahmuda1240/movie-explorer/blob/main/src/api/tvmaze.js): `src/api/tvmaze.js`

### Other components

- **Visitor**
- **TVMaze API**

## Connections

- Visitor → React Entry: opens app (evidence: `src/main.jsx`)
- React Entry → Route Shell: renders (evidence: `src/main.jsx`)
- Route Shell → Navigation Bar: renders (evidence: `src/App.jsx`)
- Route Shell → Footer: renders (evidence: `src/App.jsx`)
- Route Shell → Home Page: routes to (evidence: `src/App.jsx`)
- Route Shell → Browse Page: routes to (evidence: `src/App.jsx`)
- Home Page → Home Hero: renders (evidence: `src/pages/Home.jsx`)
- Home Page → TVMaze Client: loads shows (evidence: `src/pages/Home.jsx`)
- Browse Page → TVMaze Client: loads shows (evidence: `src/pages/Movies.jsx`)
- Browse Page → TVMaze Client: searches shows (evidence: `src/pages/Movies.jsx`)
- Browse Page → Show Search: renders (evidence: `src/pages/Movies.jsx`)
- Browse Page → Show Card: renders (evidence: `src/pages/Movies.jsx`)
- Browse Page → Show Details: renders (evidence: `src/pages/Movies.jsx`)
- Show Details → TVMaze Client: formats details (evidence: `src/components/MovieModal.jsx`)
- Show Card → TVMaze Client: formats show data (evidence: `src/components/MovieCard.jsx`)
- TVMaze Client → TVMaze API: requests shows (evidence: `src/api/tvmaze.js`)
