# jairc137/portafolio architecture

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

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

## Overview

##### Project type and purpose
- From the README and file tree, this is a front-end web application built with Next.js (using the new “app” directory), TypeScript, React and Tailwind CSS.
- It’s essentially a personal portfolio/resume website that uses static generation (SSG) or server-side rendering (SSR) for pages, serves static assets from `public/`, and is intended to be deployed on Vercel (or any CDN).

##### File structure
- Top-level config files:
- `next.config.ts`, `tsconfig.json` – Next.js and TypeScript configuration
- `tailwind.config.js`, `postcss.config.mjs`, `eslint.config.mjs` – Styling and linting
- `package.json`/`package-lock.json` – deps and scripts
- `public/` – static assets (PDFs, images, served directly by the CDN)
- `src/app/` – Next.js 13+ App Router pages and layouts; contains global layout, error/not-found, and nested `about` page
- `src/components/` – shared React components (Hero, Navbar, ProjectsSection, etc.) imported into pages
- No backend/API folder detected → purely front-end / static.

##### README insights
- No special backend services or external APIs documented.
- Uses `next/font` to optimize a cloud-hosted font (Geist) at build time.
- Intended for local dev via `npm run dev` and deployment on Vercel.

##### Detail
- Call out the routing flow from `src/app/page.tsx` → page components → `layout.tsx`.
- Where Tailwind config is applied and where global CSS lives.
- Build step (next build) and the serve step (next start or Vercel serverless).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client
    subgraph "Client (Browser)"
        Browser["User's Browser"]:::client
    end

    %% Hosting & CI/CD
    subgraph "Hosting & CI/CD"
        GitHub["Git Repository"]:::code
        VercelCI["Vercel CI/CD"]:::compute
        CDN["CDN (Vercel)"]:::static
    end

    %% Application
    subgraph "Application (Next.js)"
        Build["Next.js Build Pipeline"]:::compute
        Server["Next.js Server (SSG/SSR)"]:::compute
    end

    %% Codebase
    subgraph "Codebase"
        subgraph "Configurations"
            NextConfig["next.config.ts"]:::config
            TSConfig["tsconfig.json"]:::config
            TailwindConfig["tailwind.config.js"]:::config
            PostCSS["postcss.config.mjs"]:::config
            ESLint["eslint.config.mjs"]:::config
            GitIgnore[".gitignore"]:::config
            Package["package.json / package-lock.json"]:::config
            Readme["README.md"]:::config
        end
        subgraph "Pages & Layouts"
            GlobalsCSS["src/app/globals.css"]:::styles
            RootLayout["src/app/layout.tsx"]:::page
            ClientLayout["src/app/client-layout.tsx"]:::page
            HomePage["src/app/page.tsx"]:::page
            AboutPage["src/app/about/page.tsx"]:::page
            NotFound["src/app/not-found.tsx"]:::page
        end
        subgraph "Shared Components"
            Hero["src/components/Hero.tsx"]:::component
            Navbar["src/components/Navbar.tsx"]:::component
            SimpleNavbar["src/components/SimpleNavbar.tsx"]:::component
            AboutSection["src/components/About.tsx"]:::component
            Companies["src/components/CompaniesSection.tsx"]:::component
            Projects["src/components/ProjectsSection.tsx"]:::component
            ContactSec["src/components/Contact.tsx"]:::component
            SkillsComp["src/components/Skills.tsx"]:::component
            SkillsCSS["src/components/Skills.css"]:::component
        end
        subgraph "About-Specific Components"
            AwsUser["src/app/about/components/AwsUser.tsx"]:::component
            Bio["src/app/about/components/Bio.tsx"]:::component
            Canhoneros["src/app/about/components/Canhoneros.tsx"]:::component
            AboutContact["src/app/about/components/Contact.tsx"]:::component
            LifeFitness["src/app/about/components/LifeFitness.tsx"]:::component
            SimpleContact["src/app/about/components/SimpleContact.tsx"]:::component
        end
        subgraph "Public Assets"
            PDF1["public/CV-JoseJairMedrano.pdf"]:::static
            PDF2["public/CertificadoEntrenador.pdf"]:::static
            Images["public/images/"]:::static
        end
    end

    %% External Services
    ExternalFont["External Font Service (next/font)"]:::external

    %% Connections
    Browser -->|HTTPS Request| Server
    Browser -->|Fetch Asset| CDN
    Server -->|Render Pages| Browser
    Server -->|Serve Static| CDN
    Build -->|Deploy Static Files| CDN
    Build -->|Start Server| Server
    GitHub -->|Push Trigger| VercelCI
    VercelCI -->|Next Build| Build
    Build -->|Reads Codebase| NextConfig & TSConfig & TailwindConfig & PostCSS & ESLint & Package & Readme & GitIgnore
    Build -->|Processes Styles| GlobalsCSS
    Build -->|Compiles Pages| HomePage & AboutPage & NotFound & RootLayout & ClientLayout
    Build -->|Bundles Components| Hero & Navbar & SimpleNavbar & AboutSection & Companies & Projects & ContactSec & SkillsComp & SkillsCSS & AwsUser & Bio & Canhoneros & AboutContact & LifeFitness & SimpleContact
    Build -->|Inlines Fonts| ExternalFont
    Build -->|Includes Public Assets| PDF1 & PDF2 & Images

    %% Click Events
    click NextConfig "https://github.com/jairc137/portafolio/blob/main/next.config.ts"
    click TSConfig "https://github.com/jairc137/portafolio/blob/main/tsconfig.json"
    click TailwindConfig "https://github.com/jairc137/portafolio/blob/main/tailwind.config.js"
    click PostCSS "https://github.com/jairc137/portafolio/blob/main/postcss.config.mjs"
    click ESLint "https://github.com/jairc137/portafolio/blob/main/eslint.config.mjs"
    click PDF1 "https://github.com/jairc137/portafolio/blob/main/public/CV-JoseJairMedrano.pdf"
    click PDF2 "https://github.com/jairc137/portafolio/blob/main/public/CertificadoEntrenador.pdf"
    click Images "https://github.com/jairc137/portafolio/tree/main/public/images/"
    click GlobalsCSS "https://github.com/jairc137/portafolio/blob/main/src/app/globals.css"
    click RootLayout "https://github.com/jairc137/portafolio/blob/main/src/app/layout.tsx"
    click ClientLayout "https://github.com/jairc137/portafolio/blob/main/src/app/client-layout.tsx"
    click HomePage "https://github.com/jairc137/portafolio/blob/main/src/app/page.tsx"
    click AboutPage "https://github.com/jairc137/portafolio/blob/main/src/app/about/page.tsx"
    click NotFound "https://github.com/jairc137/portafolio/blob/main/src/app/not-found.tsx"
    click Hero "https://github.com/jairc137/portafolio/blob/main/src/components/Hero.tsx"
    click Navbar "https://github.com/jairc137/portafolio/blob/main/src/components/Navbar.tsx"
    click SimpleNavbar "https://github.com/jairc137/portafolio/blob/main/src/components/SimpleNavbar.tsx"
    click AboutSection "https://github.com/jairc137/portafolio/blob/main/src/components/About.tsx"
    click Companies "https://github.com/jairc137/portafolio/blob/main/src/components/CompaniesSection.tsx"
    click Projects "https://github.com/jairc137/portafolio/blob/main/src/components/ProjectsSection.tsx"
    click ContactSec "https://github.com/jairc137/portafolio/blob/main/src/components/Contact.tsx"
    click SkillsComp "https://github.com/jairc137/portafolio/blob/main/src/components/Skills.tsx"
    click SkillsCSS "https://github.com/jairc137/portafolio/blob/main/src/components/Skills.css"
    click AwsUser "https://github.com/jairc137/portafolio/blob/main/src/app/about/components/AwsUser.tsx"
    click Bio "https://github.com/jairc137/portafolio/blob/main/src/app/about/components/Bio.tsx"
    click Canhoneros "https://github.com/jairc137/portafolio/blob/main/src/app/about/components/Canhoneros.tsx"
    click AboutContact "https://github.com/jairc137/portafolio/blob/main/src/app/about/components/Contact.tsx"
    click LifeFitness "https://github.com/jairc137/portafolio/blob/main/src/app/about/components/LifeFitness.tsx"
    click SimpleContact "https://github.com/jairc137/portafolio/blob/main/src/app/about/components/SimpleContact.tsx"
    click Package "https://github.com/jairc137/portafolio/blob/main/package.json / package-lock.json"
    click GitIgnore "https://github.com/jairc137/portafolio/blob/main/.gitignore"
    click Readme "https://github.com/jairc137/portafolio/blob/main/README.md"

    %% Styles
    classDef client fill:#cce5ff,stroke:#2b6cb0,color:#2b6cb0;
    classDef compute fill:#bee3f8,stroke:#3182ce,color:#2c5282;
    classDef static fill:#c6f6d5,stroke:#2f855a,color:#276749;
    classDef code fill:#fefcbf,stroke:#d69e2e,color:#975a16;
    classDef config fill:#faf089,stroke:#d69e2e,color:#975a16;
    classDef styles fill:#faf089,stroke:#d69e2e,color:#975a16;
    classDef page fill:#faf089,stroke:#d69e2e,color:#975a16;
    classDef component fill:#faf089,stroke:#d69e2e,color:#975a16;
    classDef external fill:#fbd38d,stroke:#dd6b20,color:#975a16;
```
