# ezequiel-dev93/portafolio architecture

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

- Interactive diagram: https://gitdiagram.com/ezequiel-dev93/portafolio
- Repository: https://github.com/ezequiel-dev93/portafolio

## Overview

##### Project type and purpose
- This is a static, content‐focused personal portfolio site built with Astro (a static site generator).
- The README and file tree show it’s the “Astro Starter Kit: Basics” scaffold, customized with sections for profile, experience, projects, skills, and contact.

##### File structure
- Top‐level files:
- astro.config.mjs, tsconfig.json – Astro and TypeScript/JS tooling configs
- package.json, pnpm-lock.yaml – dependency management
- env.d.ts – ambient typings
- Directories:
- src/pages – route definitions (.astro pages translate directly to URLs)
- src/layouts – top‐level layout templates
- src/styles – global and component SCSS files
- public – static assets (images, favicon)
- dist – the build output (HTML, optimized assets ready for deployment)

##### README for additional insights
- The README confirms typical Astro commands (dev, build, preview) and no back-end services by default.
- No external databases or server APIs are part of this starter kit—purely a static front-end.

##### Main components and interactions
a. Developer workstation
– Source code (src/, public/, config files) in Git repo
– npm/pnpm toolchain + Astro CLI
b. Build system
– Astro build process (astro.config.mjs)
– SCSS compiler, PostCSS/Tailwind (if used), image optimizers
– Outputs to dist/ directory
c. Deployment platform
– Static hosting (Netlify, Vercel, GitHub Pages, or any CDN)
– Continuous Integration (optional): GitHub Actions or similar
d. End-user browser
– Fetches HTML/CSS/JS from CDN
– Executes client-side JS for interactivity (Dark Mode toggle, form validation)
e. (Optional) External integrations
– Contact form submission service (e.g., Netlify Forms, Formspree, custom API)
– Analytics, social media embeds, etc.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Environment
    Dev["Developer Environment\n(IDE, Git)"]:::dev

    %% Source Code Group
    subgraph "Source Code" 
        direction TB
        subgraph "Config Files"
            CFG1["astro.config.mjs"]:::config
            CFG2["tsconfig.json"]:::config
            CFG3["env.d.ts"]:::config
            CFG4["package.json"]:::config
            CFG5["pnpm-lock.yaml"]:::config
        end
        subgraph "Pages (src/pages)"
            P1["404.astro"]:::pages
            P2["index.astro"]:::pages
        end
        subgraph "Layouts (src/layouts)"
            L1["Layout.astro"]:::layouts
        end
        subgraph "Components (src/components)"
            direction TB
            subgraph "Core UI Components"
                C1["icons/*.astro"]:::components
                C2["layout/Header.astro"]:::components
                C3["layout/SectionFooter.astro"]:::components
                C4["ui/DarkMode.astro"]:::components
                C5["ui/MenuMovil.astro"]:::components
                C6["js/index.js"]:::components
                C7["js/validacion.js"]:::components
            end
            subgraph "Showcase Components"
                SC1["profile/about/About.astro"]:::components
                SC2["profile/card-profile/CardProfile.astro"]:::components
                SC3["experience/Experience.astro"]:::components
                SC4["projects/CardProject.astro"]:::components
                SC5["skills/Skills.astro"]:::components
                SC6["contact/Contacto.astro"]:::components
                SC7["contact/ContactForm.astro"]:::components
                SC8["contact/ContactAction.astro"]:::components
            end
        end
        subgraph "Styles (src/styles)"
            S1["app.scss"]:::styles
            subgraph "base"
                SB1["_global.scss"]:::styles
                SB2["_variables.scss"]:::styles
                SB3["_reset.scss"]:::styles
                SB4["_mixins.scss"]:::styles
            end
        end
        subgraph "Public Assets (public)"
            PA1["img/ (cards, logo)"]:::assets
        end
    end

    %% Build Pipeline
    Build["Astro Build Pipeline\n(Node.js, SCSS, Image Optimizer)"]:::build

    %% Dist Output
    Dist["dist/\n(HTML, CSS, JS, assets)"]:::output

    %% CDN / Hosting
    CDN["CDN / Static Hosting"]:::output

    %% Browser
    Browser["End-User Browser"]:::runtime

    %% External Services
    External["External Services\n(Contact Form API, Analytics)"]:::external

    %% Connections
    Dev -->|"push code"| CFG1
    Dev --> CFG2
    Dev --> CFG3
    Dev --> CFG4
    Dev --> CFG5
    CFG1 --> Build
    CFG2 --> Build
    CFG3 --> Build
    CFG4 --> Build
    CFG5 --> Build
    P1 --> Build
    P2 --> Build
    L1 --> Build
    C1 --> Build
    C2 --> Build
    C3 --> Build
    C4 --> Build
    C5 --> Build
    C6 --> Build
    C7 --> Build
    SC1 --> Build
    SC2 --> Build
    SC3 --> Build
    SC4 --> Build
    SC5 --> Build
    SC6 --> Build
    SC7 --> Build
    SC8 --> Build
    S1 --> Build
    SB1 --> Build
    SB2 --> Build
    SB3 --> Build
    SB4 --> Build
    PA1 --> Build
    Build -->|"npm run build"| Dist
    Dist -->|"deploy"| CDN
    CDN -->|"HTTP GET"| Browser
    Browser -->|"Form POST / Analytics"| External
    External -->|"API Response"| Browser

    %% Click Events
    click CFG1 "https://github.com/ezequiel-dev93/portafolio/blob/main/astro.config.mjs"
    click CFG2 "https://github.com/ezequiel-dev93/portafolio/blob/main/tsconfig.json"
    click CFG3 "https://github.com/ezequiel-dev93/portafolio/blob/main/env.d.ts"
    click CFG4 "https://github.com/ezequiel-dev93/portafolio/blob/main/package.json"
    click CFG5 "https://github.com/ezequiel-dev93/portafolio/blob/main/pnpm-lock.yaml"
    click P1 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/pages/404.astro"
    click P2 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/pages/index.astro"
    click L1 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/layouts/Layout.astro"
    click C1 "https://github.com/ezequiel-dev93/portafolio/tree/main/src/components/core/icons"
    click C2 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/core/layout/Header.astro"
    click C3 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/core/layout/SectionFooter.astro"
    click C4 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/core/ui/DarkMode.astro"
    click C5 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/core/ui/MenuMovil.astro"
    click C6 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/core/js/index.js"
    click C7 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/core/js/validacion.js"
    click SC1 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/profile/about/About.astro"
    click SC2 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/profile/card-profile/CardProfile.astro"
    click SC3 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/experience/Experience.astro"
    click SC4 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/projects/CardProject.astro"
    click SC5 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/skills/Skills.astro"
    click SC6 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/contact/Contacto.astro"
    click SC7 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/contact/ContactForm.astro"
    click SC8 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/components/showcase/contact/ContactAction.astro"
    click S1 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/styles/app.scss"
    click SB1 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/styles/base/_global.scss"
    click SB2 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/styles/base/_variables.scss"
    click SB3 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/styles/base/_reset.scss"
    click SB4 "https://github.com/ezequiel-dev93/portafolio/blob/main/src/styles/base/_mixins.scss"
    click PA1 "https://github.com/ezequiel-dev93/portafolio/tree/main/public/img"
    
    %% Styles
    classDef dev fill:#D0E8FF,stroke:#4A90E2
    classDef config fill:#B3D1FF,stroke:#1E60D6
    classDef pages fill:#B3D1FF,stroke:#1E60D6
    classDef layouts fill:#B3D1FF,stroke:#1E60D6
    classDef components fill:#B3D1FF,stroke:#1E60D6
    classDef styles fill:#B3D1FF,stroke:#1E60D6
    classDef assets fill:#B3D1FF,stroke:#1E60D6
    classDef build fill:#FFE5B4,stroke:#FF8C00
    classDef output fill:#D4F4DD,stroke:#28A745
    classDef runtime fill:#E3D4F4,stroke:#8A2BE2
    classDef external fill:#F0F0F0,stroke:#999999
```
