How lazhari/react-movies-finder works
Screenbox is a Next.js movie and TV discovery app. Users browse or search titles, open detail pages, and explore related material; other flows support genre browsing, upcoming releases, actor and collection pages, season episodes, random picks, and shareable watchlists. App Router pages coordinate requests through server actions or the TMDB client and render reusable media components. The README documents major capabilities not fully represented in sampled source; those branches are included, with relationships left out where source evidence is unavailable.
Main entry points: tmdb.ts TMDB Client · [id]/page.tsx Movie Details · [id]/page.tsx TV Details · search/page.tsx Search
Components 25
Discovery
- Home Feed
src/app/page.tsx - Search
src/app/search/page.tsx - Surprise Picker
src/app/surprise/page.tsx - Picker Actions
src/app/surprise/actions.tsx - Genre Browsing
src/app/genres - TV Browsing
src/app/tv - Upcoming Titles
src/app/upcoming/page.tsx - Home Actions
src/app/actions.tsx - Search Actions
src/app/search/actions.tsx
Title Details
- Movie Details
src/app/movies/[id]/page.tsx - Movie Hero
src/components/movies/hero.tsx - Reviews
src/components/movies/reviews.tsx - TV Details
src/app/tv/[id]/page.tsx - TV Hero
src/components/tv/hero.tsx - Season Episodes
src/app/tv/[id]/seasons/[seasonNumber]/page.tsx - Actor Filmography
src/app/actors/[id]/page.tsx - Collections
src/app/collections/[id]/page.tsx
Data Access
- TMDB Client
src/lib/api/tmdb.ts - TMDB API
Shared UI And State
- Watchlist
src/app/watchlist/page.tsx - Watchlist State
src/hooks/use-watchlist.ts - Media Cards
src/components/media/media-card.tsx - Media Carousels
src/components/media/media-carousel.tsx - Browser Local Storage
Other components
- Viewer
Connections 30
- Viewer → Home Feed: browses
- Viewer → Search: searches
- Viewer → Surprise Picker: requests pick
- Viewer → Genre Browsing: browses genres
- Viewer → TV Browsing: browses TV
- Viewer → Upcoming Titles: browses releases
- Viewer → Watchlist: opens list
- Home Feed → Home Actions: loads feed
src/app/page.tsx - Home Actions → TMDB Client: requests data
src/app/actions.tsx - Search → Media Cards: renders results
src/app/search/page.tsx - Search → Search Actions: calls search actions
src/app/search/page.tsx - Surprise Picker → Picker Actions: loads picks
src/app/surprise/page.tsx - Picker Actions → TMDB Client: queries catalog
- Genre Browsing → TMDB Client: loads genres
src/app/genres/page.tsx - TV Browsing → TMDB Client: loads shows
src/app/tv/page.tsx - Upcoming Titles → TMDB Client: loads releases
src/app/upcoming/page.tsx - Movie Details → Movie Hero: renders hero
src/app/movies/[id]/page.tsx - Movie Details → Reviews: renders reviews
src/app/movies/[id]/page.tsx - Movie Details → Media Cards: renders recommendations
src/app/movies/[id]/page.tsx - Movie Details → TMDB Client: loads details
- TV Details → TV Hero: renders hero
src/app/tv/[id]/page.tsx - TV Details → Season Episodes: presents seasons
- TV Details → Reviews: renders reviews
src/app/tv/[id]/page.tsx - TV Details → TMDB Client: loads details
- Season Episodes → TMDB Client: loads episodes
- Actor Filmography → TMDB Client: loads filmography
- Collections → TMDB Client: loads collection
src/app/collections/[id]/page.tsx - Watchlist → Watchlist State: reads list
src/app/watchlist/page.tsx - Watchlist State → Browser Local Storage: persists locally
- TMDB Client → TMDB API: fetches JSON
src/lib/api/tmdb.ts