# midudev/aprendiendo-react architecture

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

- Interactive diagram: https://gitdiagram.com/midudev/aprendiendo-react
- Repository: https://github.com/midudev/aprendiendo-react

## Overview

##### High-Level Structure

a. Project Collection Layer
- Workspace configuration (pnpm-workspace.yaml)
- Shared configuration files (.eslintignore, tsconfig.json)

b. Project Categories
Projects into categories:
- Basic React Projects (01-03)
- Technical Challenges (04, 11, 14)
- Feature-Focused Projects (05-06)
- Architecture Projects (07)
- TypeScript Integration (08-10)
- Advanced State Management (12-13)

##### Individual Project Architecture
For each project type, show:

**┌─ Project Type Template ─────────────────┐**

- ┌─ Frontend Layer ──────────────────┐  │
- React Components               │  │
- Hooks                         │  │
- Assets                        │  │
- ┘  │

- ┌─ State Management ─────────────────┐  │
- Local State (useState)          │  │
- Global State (Context/Redux)    │  │
- Query Management               │  │
- ┘  │

- ┌─ Services Layer ──────────────────┐  │
- API Integration               │  │
- External Services            │  │
- ┘  │
- ┘

##### Technology Stack Representation
- 🟦 React Components (blue)
- 🟨 JavaScript/TypeScript Logic (yellow)
- 🟩 External Services/APIs (green)
- 🟪 State Management Solutions (purple)

##### Common Patterns to Highlight
Recurring architectural patterns:
- Custom Hooks Pattern
- Component Composition
- State Management Strategies
- Service Layer Abstraction

##### Dependencies and Data Flow
→ Component relationships
⇄ Data flow between layers
⤢ External API interactions

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph MonorepoConfig["Monorepo Configuration"]
        Workspace["pnpm-workspace.yaml"]
        PackageJSON["package.json"]
        TSConfig["tsconfig.json"]
    end

    subgraph ProjectCategories["Project Categories"]
        direction TB
        
        subgraph BasicReact["Basic React Projects"]
            FollowCard["Twitter Follow Card"]:::basic
            TicTacToe["Tic Tac Toe"]:::basic
            MouseFollower["Mouse Follower"]:::basic
        end

        subgraph TechChallenges["Technical Challenges"]
            PruebaTecnica["React Technical Test"]:::challenge
            ReactQuery["React Query Comments"]:::challenge
            Router["Router Implementation"]:::challenge
        end

        subgraph FeatureProjects["Feature-Focused Projects"]
            MovieSearch["Movie Search"]:::feature
            ShoppingCart["Shopping Cart"]:::feature
        end

        subgraph TypeScriptProj["TypeScript Projects"]
            TodoTS["Todo App TS"]:::typescript
            TranslateClone["Google Translate Clone"]:::typescript
            CrudRedux["CRUD Redux"]:::typescript
        end

        subgraph StateManagement["Advanced State Management"]
            QuizZustand["JavaScript Quiz"]:::state
            CommentsQuery["Comments with React Query"]:::state
        end
    end

    subgraph ArchitecturalLayers["Common Architectural Layers"]
        direction TB
        
        subgraph FrontendLayer["Frontend Layer"]
            Components["React Components"]:::frontend
            Assets["Assets"]:::frontend
        end

        subgraph StateLayer["State Management"]
            LocalState["Local State"]:::state
            GlobalState["Global State"]:::state
            QueryManagement["Query Management"]:::state
        end

        subgraph ServicesLayer["Services Layer"]
            APIIntegration["API Integration"]:::service
            ExternalServices["External Services"]:::service
        end

        subgraph Patterns["Common Patterns"]
            CustomHooks["Custom Hooks"]:::pattern
            Testing["Testing Setup"]:::pattern
        end
    end

    %% Relationships
    MonorepoConfig --> ProjectCategories
    Components --> LocalState
    LocalState --> GlobalState
    GlobalState --> APIIntegration
    CustomHooks --> Components
    APIIntegration --> ExternalServices

    %% Click Events
    click Workspace "https://github.com/midudev/aprendiendo-react/blob/master//pnpm-workspace.yaml"
    click PackageJSON "https://github.com/midudev/aprendiendo-react/blob/master//package.json"
    click TSConfig "https://github.com/midudev/aprendiendo-react/blob/master//tsconfig.json"
    click FollowCard "https://github.com/midudev/aprendiendo-react/tree/master//projects/01-twitter-follow-card"
    click TicTacToe "https://github.com/midudev/aprendiendo-react/tree/master//projects/02-tic-tac-toe"
    click MouseFollower "https://github.com/midudev/aprendiendo-react/tree/master//projects/03-mouse-follower"
    click Components "https://github.com/midudev/aprendiendo-react/tree/master//projects/02-tic-tac-toe/src/components/"
    click GlobalState "https://github.com/midudev/aprendiendo-react/tree/master//projects/06-shopping-cart/src/context/"
    click APIIntegration "https://github.com/midudev/aprendiendo-react/tree/master//projects/04-react-prueba-tecnica/src/services/"
    click CustomHooks "https://github.com/midudev/aprendiendo-react/tree/master//projects/04-react-prueba-tecnica/src/hooks/"
    click Testing "https://github.com/midudev/aprendiendo-react/tree/master//projects/04-react-prueba-tecnica/tests/"
    click TodoTS "https://github.com/midudev/aprendiendo-react/tree/master//projects/08-todo-app-typescript"
    click TranslateClone "https://github.com/midudev/aprendiendo-react/tree/master//projects/09-google-translate-clone"
    click CrudRedux "https://github.com/midudev/aprendiendo-react/tree/master//projects/10-crud-redux"
    click Router "https://github.com/midudev/aprendiendo-react/tree/master//projects/07-midu-router/src/components/"
    click QuizZustand "https://github.com/midudev/aprendiendo-react/tree/master//projects/13-javascript-quiz-con-zustand/src/store/"

    %% Styles
    classDef frontend fill:#4299e1,color:white
    classDef state fill:#9f7aea,color:white
    classDef service fill:#48bb78,color:white
    classDef pattern fill:#ed8936,color:white
    classDef basic fill:#63b3ed,color:white
    classDef challenge fill:#f6ad55,color:white
    classDef feature fill:#68d391,color:white
    classDef typescript fill:#b794f4,color:white

    %% Legend
    subgraph Legend
        Frontend["Frontend Components"]:::frontend
        StateComp["State Management"]:::state
        ServiceComp["Services"]:::service
        PatternComp["Patterns"]:::pattern
    end
```
