# jamie-arodi/movie-app architecture

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

- Interactive diagram: https://gitdiagram.com/jamie-arodi/movie-app
- Repository: https://github.com/jamie-arodi/movie-app

## Overview

##### Project Type and Purpose
- This is a single-page application (SPA) built with React and Vite that provides movie discovery and user authentication by consuming external services (TMDB API and Supabase).
- Although there’s no custom backend code here, it interacts with external backends for data and auth.

##### High-Level Components
a. Frontend Application (React + Vite)
- Entry Point: main.tsx → App.tsx
- UI Layer: components/* and components/ui/*
- Styling: Tailwind CSS, PostCSS
b. State & Data Layer
- Global State: Zustand store (authStore.ts)
- Server State: React Query hooks (useMovies, useSearchMovies, etc.)
- Contexts: HomeContext for page-specific state
c. Services Layer (API Clients)
- auth-http-client.ts → talks to Supabase Auth
- movie-http-client.ts → talks to TMDB REST API
d. Utilities & Hooks
- Custom Hooks: useAuth, useDebounce, useAutoScroll, etc.
- Helpers: auth utils, debounce logic, pagination logic
e. External Services
- Supabase (authentication)
- TMDB API (movie data)
f. Tooling & DevOps
- Vite for build & dev server
- Dev Container & Docker Compose (in .devcontainer/)
- CI/CD Pipeline: GitHub Actions
- Deployment: Vercel (configured via vercel.json)

##### Relationships and Data Flows
- User Interaction → React UI Components
→ state/hooks (Zustand & React Query)
→ services (HTTP clients)
→ external APIs (Supabase / TMDB)
→ service responses → React Query cache or Zustand → UI updates
- Context providers wrap UI subtrees to share state without prop-drilling.
- Custom hooks coordinate UI logic, data fetching, and side effects.

##### Architectural Patterns & Design Principles
- Component-Based Architecture: each UI element has a single responsibility
- Context Pattern: avoid prop drilling for page-level state (HomeContext)
- Custom Hooks: extract reusable logic (debounce, pagination, auth flows)
- Modular Service Layer: decouple HTTP logic (api clients) from UI
- CI/CD & Dev Container: enforce consistent environments and automated tests/builds

##### Essential Elements
- Labels for each module/folder (e.g., /src/components, /src/services)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser / Client
    subgraph "Browser / Client"
        direction TB
        EntryPoint["main.tsx"]:::frontend
        App["App.tsx"]:::frontend
        subgraph "UI Components"
            direction TB
            ComponentsDir["/src/components"]:::frontend
            Footer["Footer.tsx"]:::frontend
            Hero["Hero.tsx"]:::frontend
            HomePage["Home.tsx"]:::frontend
            LoginPage["Login.tsx"]:::frontend
            SignupPage["Signup.tsx"]:::frontend
            MovieGrid["MovieGrid.tsx"]:::frontend
            MovieModal["MovieModal.tsx"]:::frontend
            TopNav["TopNav.tsx"]:::frontend
        end
        subgraph "UI Primitives"
            direction TB
            UIPrimitivesDir["/src/components/ui"]:::frontend
            Button["button.tsx"]:::frontend
            Input["input.tsx"]:::frontend
            UIUtils["utils.ts"]:::frontend
        end
        subgraph "Styling"
            direction TB
            PostCSS["postcss.config.js"]:::frontend
            GlobalCSS["index.css"]:::frontend
        end
        subgraph "State & Data"
            direction TB
            Zustand["authStore.ts"]:::state
            ReactQuery["React Query Hooks"]:::state
            useMovies["useMovies.ts"]:::state
            useSearchMovies["useSearchMovies.ts"]:::state
            useMoviesPagination["useMoviesPagination.ts"]:::state
            useSearchReset["useSearchReset.ts"]:::state
        end
        subgraph "Context & Hooks"
            direction TB
            AuthHook["useAuth.ts"]:::state
            Debounce["useDebounce.ts"]:::state
            AutoScroll["useAutoScroll.ts"]:::state
            HomeContextHook["useHomeContext.ts"]:::state
            HomeContextProvider["HomeContext.tsx"]:::state
            HomeContextDef["HomeContextDefinition.ts"]:::state
        end
        subgraph "Services Layer"
            direction TB
            AuthClient["auth-http-client.ts"]:::service
            MovieClient["movie-http-client.ts"]:::service
        end
        EntryPoint -->|imports| App
        App -->|renders| ComponentsDir
        App -->|wraps| HomeContextProvider
        ComponentsDir --> Footer
        ComponentsDir --> Hero
        ComponentsDir --> HomePage
        ComponentsDir --> LoginPage
        ComponentsDir --> SignupPage
        ComponentsDir --> MovieGrid
        ComponentsDir --> MovieModal
        ComponentsDir --> TopNav
        UIPrimitivesDir --> Button
        UIPrimitivesDir --> Input
        UIPrimitivesDir --> UIUtils
        App -->|uses| Zustand
        App -->|uses| ReactQuery
        App -->|uses| AuthHook
        App -->|uses| Debounce
        App -->|uses| AutoScroll
        HomePage -->|uses| HomeContextHook
        HomeContextHook --> HomeContextProvider
        Zustand --> AuthClient
        ReactQuery --> MovieClient
        AuthClient --> Supabase
        MovieClient --> TMDB
    end

    %% External Services
    subgraph "External Services"
        direction TB
        Supabase[(Supabase Auth)]:::external
        TMDB[(TMDB API)]:::external
    end

    %% DevOps & Tooling
    subgraph "DevOps & Tooling"
        direction TB
        DevContainer[".devcontainer"]:::tooling
        Dockerfile["Dockerfile"]:::tooling
        DockerCompose["docker-compose.yml"]:::tooling
        DevContainerConfig["devcontainer.json"]:::tooling
        SetupScript["setup.sh"]:::tooling
        DevReadme["README.md"]:::tooling
        CI[".github/workflows/ci-cd.yml"]:::tooling
        Vercel["vercel.json"]:::tooling
    end

    %% CI/CD Flow
    GitPush["Git Push"]:::tooling
    GitPush --> CI
    CI --> Vercel

    %% Styling and Positions
    Supabase -.->|responds| AuthClient
    TMDB -.->|responds| MovieClient

    %% Click Events
    click EntryPoint "https://github.com/jamie-arodi/movie-app/blob/main/src/main.tsx"
    click App "https://github.com/jamie-arodi/movie-app/blob/main/src/App.tsx"
    click ComponentsDir "https://github.com/jamie-arodi/movie-app/tree/main/src/components"
    click Footer "https://github.com/jamie-arodi/movie-app/blob/main/src/components/Footer.tsx"
    click Hero "https://github.com/jamie-arodi/movie-app/blob/main/src/components/Hero.tsx"
    click HomePage "https://github.com/jamie-arodi/movie-app/blob/main/src/components/Home.tsx"
    click LoginPage "https://github.com/jamie-arodi/movie-app/blob/main/src/components/Login.tsx"
    click SignupPage "https://github.com/jamie-arodi/movie-app/blob/main/src/components/Signup.tsx"
    click MovieGrid "https://github.com/jamie-arodi/movie-app/blob/main/src/components/MovieGrid.tsx"
    click MovieModal "https://github.com/jamie-arodi/movie-app/blob/main/src/components/MovieModal.tsx"
    click TopNav "https://github.com/jamie-arodi/movie-app/blob/main/src/components/TopNav.tsx"
    click UIPrimitivesDir "https://github.com/jamie-arodi/movie-app/tree/main/src/components/ui"
    click Button "https://github.com/jamie-arodi/movie-app/blob/main/src/components/ui/button.tsx"
    click Input "https://github.com/jamie-arodi/movie-app/blob/main/src/components/ui/input.tsx"
    click UIUtils "https://github.com/jamie-arodi/movie-app/blob/main/src/components/ui/utils.ts"
    click PostCSS "https://github.com/jamie-arodi/movie-app/blob/main/postcss.config.js"
    click GlobalCSS "https://github.com/jamie-arodi/movie-app/blob/main/src/index.css"
    click Zustand "https://github.com/jamie-arodi/movie-app/blob/main/src/store/authStore.ts"
    click useMovies "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useMovies.ts"
    click useSearchMovies "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useSearchMovies.ts"
    click useMoviesPagination "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useMoviesPagination.ts"
    click useSearchReset "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useSearchReset.ts"
    click AuthHook "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useAuth.ts"
    click Debounce "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useDebounce.ts"
    click AutoScroll "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useAutoScroll.ts"
    click HomeContextHook "https://github.com/jamie-arodi/movie-app/blob/main/src/hooks/useHomeContext.ts"
    click HomeContextProvider "https://github.com/jamie-arodi/movie-app/blob/main/src/contexts/HomeContext.tsx"
    click HomeContextDef "https://github.com/jamie-arodi/movie-app/blob/main/src/contexts/HomeContextDefinition.ts"
    click AuthClient "https://github.com/jamie-arodi/movie-app/blob/main/src/services/auth-http-client.ts"
    click MovieClient "https://github.com/jamie-arodi/movie-app/blob/main/src/services/movie-http-client.ts"
    click DevContainer "https://github.com/jamie-arodi/movie-app/blob/main/ .devcontainer"
    click Dockerfile "https://github.com/jamie-arodi/movie-app/tree/main/.devcontainer/Dockerfile"
    click DockerCompose "https://github.com/jamie-arodi/movie-app/blob/main/.devcontainer/docker-compose.yml"
    click DevContainerConfig "https://github.com/jamie-arodi/movie-app/blob/main/.devcontainer/devcontainer.json"
    click SetupScript "https://github.com/jamie-arodi/movie-app/blob/main/.devcontainer/setup.sh"
    click DevReadme "https://github.com/jamie-arodi/movie-app/blob/main/.devcontainer/README.md"
    click CI "https://github.com/jamie-arodi/movie-app/blob/main/.github/workflows/ci-cd.yml"
    click Vercel "https://github.com/jamie-arodi/movie-app/blob/main/vercel.json"

    %% Classes
    classDef frontend fill:#e3f2fd,stroke:#2196f3,stroke-width:1px
    classDef state fill:#f3e5f5,stroke:#9c27b0,stroke-width:1px
    classDef service fill:#e0f7fa,stroke:#00acc1,stroke-width:1px
    classDef external fill:#e8f5e9,stroke:#4caf50,stroke-width:1px
    classDef tooling fill:#fafafa,stroke:#9e9e9e,stroke-width:1px
```
