# karafiziartur/the-movie-db-redux architecture

> Architecture diagram of the GitHub repository karafiziartur/the-movie-db-redux, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/karafiziartur/the-movie-db-redux
- Repository: https://github.com/karafiziartur/the-movie-db-redux

## Overview

##### Project type and purpose
- This is a client‐side, single‐page web application built with Create React App, using React for views, Redux for state management and React-Router-Redux for routing.
- It fetches movie data from the external TheMovieDB API and uses Firebase for user authentication (and potentially user‐specific data such as favorites).
- The deployment target is static hosting (via create-react-app-buildpack), so there’s no custom backend server code in this repo.

##### File structure
- Top-level:
- public/index.html (hosted entry point)
- src/
– components/ (pure, presentational React components, each with its CSS)
– containers/ (“smart” components wired to Redux and side-effects, e.g. LoginModal, PopularMoviesPageContainer)
– actions/ (Redux action creators for movies, genres, user)
– reducers/ (Redux reducers: moviesReducer, genresReducer, userReducer, combined in index.js)
– store/ (store configuration: apply middleware, create Redux store)
– routes/ (React-Router route definitions)
– config/ (third-party API configurations: Firebase & TMDB)
– helpers/ (utility functions: API wrappers, data massaging)
– index.js & App.js (bootstrapping React, connecting Redux, mounting Router)
- Notice the Flux/Redux pattern: unidirectional data flow from actions → reducers → store → view.
- There are no backend source files: integration with external services happens via client‐side HTTP calls.

##### Key architecture notes from README
- Uses React, Redux, React-Router-Redux for client routing and state, Material-UI for styling.
- TMDB API key and Firebase config are injected via src/config.
- Deployment is static—no Node/Express or custom server code.

- User click → Action dispatch
- Action → API Call
- API Response → Reducer → Store → UI update
- React layers (light blue)
- Redux layers (light green)
- External services (orange)

## Diagram (Mermaid)

```mermaid
flowchart TB
    User["User Browser"]:::client
    Static["Static Host/CDN\n(serves public/index.html & JS bundles)"]:::external
    IndexFile["public/index.html"]:::external
    ReactIndex["src/index.js"]:::react
    AppComp["src/App.js"]:::react

    subgraph "React App"
        subgraph "UI Layer"
            CompDir["components/"]:::react
            Footer["Footer.js"]:::react
            LoadMore["LoadMoreButton.js"]:::react
            MoviesList["MoviesList.js"]:::react
            MovieDetailsComp["MovieDetailsPage.js"]:::react
            Recommended["RecommendedMovies.js"]:::react
        end
        subgraph "Container Layer"
            ContainersDir["containers/"]:::react
            PopularContainer["PopularMoviesPageContainer.js"]:::react
            DetailsContainer["MovieDetailsPageContainer.js"]:::react
            FavoriteContainer["FavoriteMoviesPageContainer.js"]:::react
            LoginModal["LoginModal.js"]:::react
            SignupModal["SignupModal.js"]:::react
            Navbar["Navbar.js"]:::react
            SearchPage["SearchMoviesPageContainer.js"]:::react
            SearchInput["SearchInput.js"]:::react
        end
        subgraph "State Management"
            subgraph "Actions"
                ActionsDir["actions/"]:::redux
                MoviesActions["moviesActions.js"]:::redux
                MovieAction["movieActions.js"]:::redux
                GenresActions["genresActions.js"]:::redux
                UserActions["userActions.js"]:::redux
            end
            subgraph "Reducers"
                ReducersDir["reducers/"]:::redux
                CombinedReducers["index.js"]:::redux
                MoviesReducer["moviesReducer.js"]:::redux
                MovieReducer["movieReducer.js"]:::redux
                GenresReducer["genresReducer.js"]:::redux
                UserReducer["userReducer.js"]:::redux
            end
            Store["src/store/index.js\n(Redux Store)"]:::redux
        end
        subgraph "Routing"
            Routes["src/routes/index.js"]:::react
        end
        subgraph "Configuration"
            ConfigDir["src/config/"]:::react
            FirebaseConfig["firebaseConfig.js"]:::react
            TMDBConfig["theMovieDBConfig.js"]:::react
        end
        subgraph "Helpers/API Layer"
            Helpers["src/helpers/index.js"]:::react
        end
    end

    TMDB["TheMovieDB REST API"]:::external
    Firebase["Firebase Auth & Firestore"]:::external

    %% Data Flow
    User -->|"opens app"| Static
    Static --> IndexFile
    Static --> ReactIndex
    ReactIndex --> AppComp
    AppComp --> Routing
    Routing --> ContainersDir
    ContainersDir --> CompDir
    ContainersDir --> ActionsDir
    ActionsDir --> Helpers
    Helpers -->|HTTP call| TMDB
    Helpers -->|HTTP call| Firebase
    TMDB -->|response| Helpers
    Firebase -->|response| Helpers
    Helpers --> ActionsDir
    ActionsDir --> CombinedReducers
    CombinedReducers --> Store
    Store --> ContainersDir
    ContainersDir --> CompDir

    %% Click Events
    click CompDir "https://github.com/karafiziartur/the-movie-db-redux/tree/master/src/components/"
    click Footer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/components/Footer.js"
    click LoadMore "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/components/LoadMoreButton.js"
    click MoviesList "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/components/MoviesList.js"
    click MovieDetailsComp "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/components/MovieDetailsPage.js"
    click Recommended "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/components/RecommendedMovies.js"
    click ContainersDir "https://github.com/karafiziartur/the-movie-db-redux/tree/master/src/containers/"
    click PopularContainer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/PopularMoviesPageContainer.js"
    click DetailsContainer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/MovieDetailsPageContainer.js"
    click FavoriteContainer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/FavoriteMoviesPageContainer.js"
    click LoginModal "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/LoginModal.js"
    click SignupModal "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/SignupModal.js"
    click Navbar "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/Navbar.js"
    click SearchPage "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/SearchMoviesPageContainer.js"
    click SearchInput "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/containers/SearchInput.js"
    click ActionsDir "https://github.com/karafiziartur/the-movie-db-redux/tree/master/src/actions/"
    click MoviesActions "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/actions/moviesActions.js"
    click MovieAction "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/actions/movieActions.js"
    click GenresActions "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/actions/genresActions.js"
    click UserActions "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/actions/userActions.js"
    click ReducersDir "https://github.com/karafiziartur/the-movie-db-redux/tree/master/src/reducers/"
    click CombinedReducers "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/reducers/index.js"
    click MoviesReducer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/reducers/moviesReducer.js"
    click MovieReducer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/reducers/movieReducer.js"
    click GenresReducer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/reducers/genresReducer.js"
    click UserReducer "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/reducers/userReducer.js"
    click Store "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/store/index.js"
    click Routes "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/routes/index.js"
    click ConfigDir "https://github.com/karafiziartur/the-movie-db-redux/tree/master/src/config/"
    click FirebaseConfig "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/config/firebaseConfig.js"
    click TMDBConfig "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/config/theMovieDBConfig.js"
    click Helpers "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/helpers/index.js"
    click ReactIndex "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/index.js"
    click AppComp "https://github.com/karafiziartur/the-movie-db-redux/blob/master/src/App.js"
    click IndexFile "https://github.com/karafiziartur/the-movie-db-redux/blob/master/public/index.html"

    %% Styles
    classDef react fill:#D0E8FF,stroke:#0B78D0
    classDef redux fill:#D0FFDA,stroke:#0B8D3E
    classDef external fill:#FFDDA0,stroke:#D0770A
    classDef client fill:#FFE0E0,stroke:#D04545
```
