# jonasschmedtmann/ultimate-react-course architecture

> Architecture diagram of the GitHub repository jonasschmedtmann/ultimate-react-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-03-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jonasschmedtmann/ultimate-react-course
- Repository: https://github.com/jonasschmedtmann/ultimate-react-course

## Overview

This repository is not a “monolithic” application in the traditional sense but rather a collection of independent projects – each one representing a module or “lesson” in the Ultimate React Course. The overall purpose is to provide both starter and final versions of diverse projects that teach various aspects of React (from pure React, state management, routing, SSR with Next.js, to advanced patterns like React Query, Redux, and NextAuth). Each top-level folder (e.g., “03-pizza-menu”, “05-travel-list”, “16-fast-react-pizza”, “17-the-wild-oasis”, “21-the-wild-oasis-website”, etc.) contains its own independent project and internal structure.

##### Overall Structure
- Under this umbrella, identify multiple projects as separate modules. Group them by their intended focus if possible (for example, “Basic React Projects” such as Pizza Menu, Travel List, Eat-n-Split; “Advanced Concepts” such as Redux Intro, Fast React Pizza, The Wild Oasis; and “Next.js based projects” like The Wild Oasis Website and Nextjs Pages Router).
- Supporting folders like “00-setup” and “02-JS-review” that provide initial tooling or review content.

##### For Each Project Module
- Project as its own component/node.
- Directories that are common in these projects:
– A “src” folder containing the application’s source code.
– A “public” folder containing static assets (HTML, manifest, robots.txt, etc.).
– Configuration files such as package.json, ESLint configurations, babel settings, or build scripts.

##### Relationships and Architectural Patterns
– Frontend “components” (React components housed under “src/components” or similar folders) send/receive data.
– If applicable, highlight any API or service modules (for instance, in projects that fetch data from an external API or use Supabase).
– Show context providers or state management modules (for example, the Redux store, context API files, or custom hooks such as “useMovies” in the usePopcorn project).
- For projects like “20-manual-ssr” or those using Next.js (e.g., “21-the-wild-oasis-website”, “22-nextjs-pages-router”), clearly distinguish between server-side and client-side:
– Mark server files (such as server.js, API routes, or server actions) and client components.

## Diagram (Mermaid)

```mermaid
graph TD
  %% Top-level Repository
  R["Course Repository"]:::hub

  %% Supporting Materials Subgraph
  subgraph "Supporting Materials"
    ST1["00-setup"]:::support
    ST2["02-JS-review"]:::support
  end

  %% Basic React Projects Subgraph
  subgraph "Basic React Projects"
    P1["03-pizza-menu"]:::basic
    P2["05-travel-list"]:::basic
    P3["06-eat-n-split"]:::basic
    %% 03-pizza-menu internal structure
    P1S["Starter"]:::starter
    P1F["Final"]:::final
    P1F1["src"]:::final
    P1F2["public"]:::final
  end

  %% Advanced Concepts Subgraph
  subgraph "Advanced Concepts"
    A1["15-redux-intro"]:::advanced
    A1F["final/src/features"]:::final
    A2["16-fast-react-pizza"]:::advanced
    A2_1["features"]:::final
    A2_2["services"]:::final
    A2_3["ui"]:::final
  end

  %% SSR/Next.js Projects Subgraph
  subgraph "SSR/Next.js Projects"
    S1["20-manual-ssr"]:::ssr
    S1a["server.js"]:::ssr
    S1b["client.js"]:::ssr
    S1c["configurations"]:::ssr
    S2["21-the-wild-oasis-website"]:::ssr
    S2a["pages"]:::ssr
    S2b["app"]:::ssr
    S2c["components"]:::ssr
    S2d["next.config.mjs"]:::ssr
    S2e["tailwind.config.js"]:::ssr
    S3["22-nextjs-pages-router"]:::ssr
    S3S["Starter"]:::starter
    S3F["Final"]:::final
    S3F1["pages"]:::final
    S3F2["components"]:::final
    S3F3["lib"]:::final
  end

  %% Connections from Course Repository to Groups
  R --> ST1
  R --> P1
  R --> A1
  R --> S1

  %% Internal connections Basic React Projects (for 03-pizza-menu)
  P1 --> P1S
  P1 --> P1F
  P1F --> P1F1
  P1F --> P1F2
  %% Simulate bundling flow within final version
  P1F1 -->|"bundlesTo"| P1F2

  %% Internal connections Advanced Concepts
  A1 --> A1F
  A2 --> A2_1
  A2 --> A2_2
  A2 --> A2_3

  %% Internal connections SSR/Next.js Projects
  S1 --> S1a
  S1 --> S1b
  S1 --> S1c
  S2 --> S2a
  S2 --> S2b
  S2 --> S2c
  S2 --> S2d
  S2 --> S2e
  S3 --> S3S
  S3 --> S3F
  S3F --> S3F1
  S3F --> S3F2
  S3F --> S3F3

  %% Click Events for Component Mapping
  click R "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/Root Directory"
  click P1S "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/03-pizza-menu/starter"
  click P1F "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/03-pizza-menu/final"
  click P1F1 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/03-pizza-menu/final/src"
  click P1F2 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/03-pizza-menu/final/public"
  click A1F "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/15-redux-intro/final/src/features"
  click A2_1 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/16-fast-react-pizza/features"
  click A2_2 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/16-fast-react-pizza/services"
  click A2_3 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/16-fast-react-pizza/ui"
  click S1 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/20-manual-ssr"
  click S2 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/21-the-wild-oasis-website"
  click S3 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/22-nextjs-pages-router"
  click ST1 "https://github.com/jonasschmedtmann/ultimate-react-course/blob/main/00-setup/snippets.json"
  click ST2 "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/02-JS-review"
  click S3S "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/22-nextjs-pages-router/starter"
  click S3F "https://github.com/jonasschmedtmann/ultimate-react-course/tree/main/22-nextjs-pages-router/final"

  %% Class Definitions for Colors
  classDef hub fill:#ffcc00,stroke:#333,stroke-width:2px;
  classDef support fill:#ccffcc,stroke:#333,stroke-width:2px;
  classDef basic fill:#cce5ff,stroke:#333,stroke-width:2px;
  classDef advanced fill:#ffcccc,stroke:#333,stroke-width:2px;
  classDef ssr fill:#e6ccff,stroke:#333,stroke-width:2px;
  classDef starter fill:#d1e7dd,stroke:#333,stroke-width:1px;
  classDef final fill:#f8d7da,stroke:#333,stroke-width:1px;
```
