# juandigo1/juanmaestre architecture

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

- Interactive diagram: https://gitdiagram.com/juandigo1/juanmaestre
- Repository: https://github.com/juandigo1/juanmaestre

## Overview

##### Main Components and Their Roles
- Frontend Application – This is the React application, which includes all the user interface elements.
- Components: Note the various folders under src/components (About, Contact, DecryptedText, Footer, Lanyard, Particles, Projects, Skills, navbar). Each of these represents a discrete part of the UI.
- Global Styling: Files like App.css, index.css, and Tailwind CSS integration (as stated in the README) reflect the styling infrastructure.
- Entry Points / Configuration:
- src/main.jsx and index.html: These files serve as the entry points for rendering the application.
- Vite Configuration: vite.config.js indicates that Vite is used as the build tool.
- Assets:
- public folder holds static files (e.g., CV PDFs) and images/models (e.g., glb files in assets or in components/Lanyard).
- Deployment Pipeline:
- Vercel is used for deployment, which means the project is built and deployed on Vercel’s hosting platform.

##### Relationships and Interactions
- UI Composition: Identify the hierarchical relationships between the components. For example, the main App.jsx might aggregate components like the navbar, about section, projects, skills, and footer.
- Build and Deployment Flow: Demonstrate the build process using Vite (source code → Vite bundling → production build) and then deployment on Vercel.

##### Architectural Patterns and Design Principles
- Separation of Concerns: The clear partition between the static public resources and the dynamic source code, alongside the configuration files (e.g., package.json, vite.config.js, eslint.config.js), emphasizes modularity.
- Modern Build Pipeline: The inclusion of Vite and ESLint configurations shows that the project benefits from a fast development server and good code quality practices.

##### Technologies and Their Placement
- React: The core framework for building the UI.
- Tailwind CSS: Utilized for styling components.
- Vite: Build and development tool that compiles and bundles the source modules.
- Vercel: Cloud platform for deployment and hosting.
- Additional Assets: 3D models (glb) in the assets and Lanyard folder that might be used to render interactive UI elements.

## Diagram (Mermaid)

```mermaid
flowchart TD

    %% Entry Points
    subgraph "Entry Points"
        index["index.html"]:::entry
        main["src/main.jsx"]:::entry
    end

    %% Frontend Application
    app["App.jsx"]:::ui

    %% UI Components
    subgraph "UI Components"
        navbar["Navbar"]:::ui
        about["About Section"]:::ui
        projects["Projects Section"]:::ui
        projectCard["Project Card"]:::ui
        skills["Skills Section"]:::ui
        skillsAlt["Skills (Alternate)"]:::ui
        contact["Contact Section"]:::ui
        footer["Footer Component"]:::ui
        decrypted["DecryptedText"]:::ui
        lanyard["Lanyard"]:::ui
        particles["Particles"]:::ui
    end

    %% Global Styling
    subgraph "Styling & Assets (Code)"
        appstyling["App.css"]:::config
        indexcss["index.css"]:::config
        tailwind["TailwindCSS Integration"]:::config
    end

    %% Build & Configuration
    subgraph "Build & Config"
        vite["Vite Configuration"]:::config
        eslint["ESLint Configuration"]:::config
        package["package.json"]:::config
        build["Production Build"]:::config
    end

    %% External Deployment
    deploy["Vercel Deployment"]:::external

    %% Assets
    subgraph "Assets"
        public["public/ (CVs, Static Files)"]:::assets
        lanyardAssets["src/assets/lanyard/ (3D Models)"]:::assets
        lanyardModel["Lanyard-3D Model"]:::assets
    end

    %% Connections: Entry & App
    main -->|"loads"| app
    index -->|"defines structure"| app

    %% App renders UI Components
    app -->|"renders"| navbar
    app -->|"renders"| about
    app -->|"renders"| projects
    app -->|"renders"| skills
    app -->|"renders"| contact
    app -->|"renders"| footer
    app -->|"renders"| decrypted
    app -->|"renders"| lanyard
    app -->|"renders"| particles

    %% UI Component internal compositions
    projects -->|"contains"| projectCard
    skills -->|"enhances"| skillsAlt

    %% Linking Styling with Application
    appstyling --- app
    indexcss --- app
    tailwind --- app

    %% Build & Deployment Flow
    app --- vite
    vite --> build
    build --> deploy
    eslint --- package

    %% Assets usage
    public --- app
    lanyardAssets --> lanyard
    lanyardModel --> lanyard

    %% Click Events for Components
    click app "https://github.com/juandigo1/juanmaestre/blob/main/src/App.jsx"
    click navbar "https://github.com/juandigo1/juanmaestre/blob/main/src/components/navbar/navbar.jsx"
    click about "https://github.com/juandigo1/juanmaestre/tree/main/src/components/About/"
    click contact "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Contact/Contact.tsx"
    click decrypted "https://github.com/juandigo1/juanmaestre/blob/main/src/components/DecryptedText/DecryptedText.jsx"
    click footer "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Footer/Footer.tsx"
    click lanyard "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Lanyard/Lanyard.jsx"
    click particles "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Particles/Particles.jsx"
    click projects "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Projects/Projects.tsx"
    click projectCard "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Projects/Card_Project.tsx"
    click skills "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Skills/Tecnologies.tsx"
    click skillsAlt "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Skills/tecnologie.jsx"
    click main "https://github.com/juandigo1/juanmaestre/blob/main/src/main.jsx"
    click index "https://github.com/juandigo1/juanmaestre/blob/main/index.html"
    click appstyling "https://github.com/juandigo1/juanmaestre/blob/main/src/App.css"
    click indexcss "https://github.com/juandigo1/juanmaestre/blob/main/src/index.css"
    click vite "https://github.com/juandigo1/juanmaestre/blob/main/vite.config.js"
    click eslint "https://github.com/juandigo1/juanmaestre/blob/main/eslint.config.js"
    click package "https://github.com/juandigo1/juanmaestre/blob/main/package.json"
    click public "https://github.com/juandigo1/juanmaestre/tree/main/public/"
    click lanyardAssets "https://github.com/juandigo1/juanmaestre/tree/main/src/assets/lanyard/"
    click lanyardModel "https://github.com/juandigo1/juanmaestre/blob/main/src/components/Lanyard/card.glb"

    %% Styles
    classDef ui fill:#AEDFF7,stroke:#333,stroke-width:2px;
    classDef config fill:#F7E1AE,stroke:#333,stroke-width:2px;
    classDef assets fill:#BDE3B0,stroke:#333,stroke-width:2px;
    classDef external fill:#FFCCCB,stroke:#333,stroke-width:2px;
    classDef entry fill:#E0BBE4,stroke:#333,stroke-width:2px;
```
