# marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite architecture

> Architecture diagram of the GitHub repository marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite, 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/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite
- Repository: https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite

## Overview

Movie Explorer is a React discovery app: visitors navigate from the landing page to a show catalog, load or search TVMaze titles, and open a selected title’s details in a URL-synchronized modal. The listing page owns loading, debouncing, search state and selection; the API layer fetches and normalizes results, while reusable components render cards, skeletons and details. The README documents responsive styling and error/fallback behavior; only sampled source relationships are wired below, so unsampled behavior is represented without speculative edges.

Main entry points: [`src/pages/MovieListingPage.jsx`](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/pages/MovieListingPage.jsx) (Catalog and search), [`src/App.jsx`](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/App.jsx) (Routes and shell), [`src/components/MovieGrid.jsx`](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieGrid.jsx) (Results grid), [`src/main.jsx`](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/main.jsx) (React application router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_router["React application router<br/>[main.jsx]"]
  node_app["Routes and shell<br/>[App.jsx]"]
  node_home["Home page<br/>[HomePage.jsx]"]
  node_hero["Hero banner<br/>[HeroBanner.jsx]"]
  node_navbar["Navigation bar<br/>[Navbar.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_discovery["Show discovery"]
  node_listing["Catalog and search"]
  node_search["Search input<br/>[SearchBar.jsx]"]
  node_urlstate["URL search state"]
end

subgraph group_presentation["Show presentation"]
  node_grid["Results grid<br/>[MovieGrid.jsx]"]
  node_card["Show card<br/>[MovieCard.jsx]"]
  node_skeleton["Loading skeleton"]
  node_modal["Details modal<br/>[MovieModal.jsx]"]
end

subgraph group_integration["TVMaze integration"]
  node_api["TVMaze API client<br/>[tvmaze.js]"]
end

node_visitor(("Visitor"))
node_tvmaze{{"TVMaze service"}}

node_visitor -->|"opens app"| node_router
node_router -->|"renders"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_listing
node_app -->|"renders"| node_footer
node_home -->|"renders"| node_hero
node_hero -->|"navigates to"| node_listing
node_visitor -->|"browses"| node_listing
node_listing -->|"reads and updates"| node_urlstate
node_listing -->|"renders"| node_search
node_search -->|"changes query"| node_listing
node_listing -->|"fetches catalog and results"| node_api
node_api -->|"requests data"| node_tvmaze
node_listing -->|"supplies results"| node_grid
node_grid -->|"renders"| node_card
node_grid -->|"renders while loading"| node_skeleton
node_card -->|"selects show"| node_listing
node_listing -->|"renders selected show"| node_modal
node_modal -->|"requests close"| node_listing

click node_router "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/main.jsx"
click node_app "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/App.jsx"
click node_home "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/pages/HomePage.jsx"
click node_hero "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/HeroBanner.jsx"
click node_navbar "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/Navbar.jsx"
click node_footer "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/Footer.jsx"
click node_listing "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/pages/MovieListingPage.jsx"
click node_search "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/SearchBar.jsx"
click node_urlstate "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/pages/MovieListingPage.jsx"
click node_api "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/api/tvmaze.js"
click node_grid "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieGrid.jsx"
click node_card "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieCard.jsx"
click node_skeleton "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieCardSkeleton.jsx"
click node_modal "https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieModal.jsx"

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_router,node_app,node_home,node_hero,node_navbar,node_footer toneBlue
class node_listing,node_search,node_urlstate toneAmber
class node_grid,node_card,node_skeleton,node_modal toneMint
class node_api toneRose
class node_visitor,node_tvmaze toneIndigo
```

## Components

### App experience

- [React application router](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/main.jsx): `src/main.jsx`
- [Routes and shell](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/App.jsx): `src/App.jsx`
- [Home page](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/pages/HomePage.jsx): `src/pages/HomePage.jsx`
- [Hero banner](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/HeroBanner.jsx): `src/components/HeroBanner.jsx`
- [Navigation bar](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Footer](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/Footer.jsx): `src/components/Footer.jsx`

### Show discovery

- [Catalog and search](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/pages/MovieListingPage.jsx): `src/pages/MovieListingPage.jsx`
- [Search input](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/SearchBar.jsx): `src/components/SearchBar.jsx`
- [URL search state](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/pages/MovieListingPage.jsx): `src/pages/MovieListingPage.jsx`

### Show presentation

- [Results grid](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieGrid.jsx): `src/components/MovieGrid.jsx`
- [Show card](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieCard.jsx): `src/components/MovieCard.jsx`
- [Loading skeleton](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieCardSkeleton.jsx): `src/components/MovieCardSkeleton.jsx`
- [Details modal](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/components/MovieModal.jsx): `src/components/MovieModal.jsx`

### TVMaze integration

- [TVMaze API client](https://github.com/marleydip/programming-hero_foundation-program-assignment-02_movie-explorer_react-tailwind-css-routing-vite/blob/main/src/api/tvmaze.js): `src/api/tvmaze.js`

### Other components

- **Visitor**
- **TVMaze service**

## Connections

- Visitor → React application router: opens app
- React application router → Routes and shell: renders (evidence: `src/main.jsx`)
- Routes and shell → Navigation bar: renders (evidence: `src/App.jsx`)
- Routes and shell → Home page: routes to (evidence: `src/App.jsx`)
- Routes and shell → Catalog and search: routes to (evidence: `src/App.jsx`)
- Routes and shell → Footer: renders (evidence: `src/App.jsx`)
- Home page → Hero banner: renders (evidence: `src/pages/HomePage.jsx`)
- Hero banner → Catalog and search: navigates to (evidence: `src/components/HeroBanner.jsx`)
- Visitor → Catalog and search: browses
- Catalog and search → URL search state: reads and updates (evidence: `src/pages/MovieListingPage.jsx`)
- Catalog and search → Search input: renders (evidence: `src/pages/MovieListingPage.jsx`)
- Search input → Catalog and search: changes query (evidence: `src/pages/MovieListingPage.jsx`)
- Catalog and search → TVMaze API client: fetches catalog and results (evidence: `src/pages/MovieListingPage.jsx`)
- TVMaze API client → TVMaze service: requests data (evidence: `src/api/tvmaze.js`)
- Catalog and search → Results grid: supplies results (evidence: `src/pages/MovieListingPage.jsx`)
- Results grid → Show card: renders (evidence: `src/components/MovieGrid.jsx`)
- Results grid → Loading skeleton: renders while loading (evidence: `src/components/MovieGrid.jsx`)
- Show card → Catalog and search: selects show (evidence: `src/pages/MovieListingPage.jsx`)
- Catalog and search → Details modal: renders selected show (evidence: `src/pages/MovieListingPage.jsx`)
- Details modal → Catalog and search: requests close (evidence: `src/pages/MovieListingPage.jsx`)
