# ryanbalieiro/react-portfolio-template architecture

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

- Interactive diagram: https://gitdiagram.com/ryanbalieiro/react-portfolio-template
- Repository: https://github.com/ryanbalieiro/react-portfolio-template

## Overview

##### Project type and purpose
- This is a single-page, **frontend-only** React portfolio template. There is **no custom backend**—all data comes from JSON files in `public/data` and email functionality is handled by the external EmailJS service.
- It’s built with **React**, **Vite** (for bundling), **Bootstrap 5**, Sass, and a handful of JS utilities (hooks, provider components).

##### File structure
- Top-level directories:
- `src/` – React source code (components, hooks, providers, styles, main entry)
- `public/` – static assets (audio, images, JSON data files)
- `npm/` – custom CLI helpers for resume generation
- `docs/` – tutorial and branding assets
- Root configs: `vite.config.js`, `package.json`, `.github/workflows/deploy.yml`
- Notice a clear **component-based** layout under `src/components` (articles, buttons, modals, etc.), **Context Providers** in `src/providers`, and **utility hooks** in `src/hooks`.
- Build & deployment: Vite handles packaging, GitHub Actions deploys to GitHub Pages.

##### README for additional insights
- Lists core technologies (React, Bootstrap, Vite, EmailJS, Swiper, Smooth Scrollbar, Font Awesome, PrimeIcons).
- Emphasizes multi-language support, theming (dark/light), responsive layout (sidebar + main view on desktop, bottom nav on mobile).
- Tutorials show that content is entirely driven by JSON configuration—no backend.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Developer Environment"
        FS["Local Filesystem (Git Repo)"]:::build
        PKG["package.json"]:::build
        VITECFG["vite.config.js"]:::build
        NPM["npm install & scripts"]:::build
    end

    subgraph "CI/CD Pipeline"
        GHA["GitHub Actions"]:::build
        DEPLOYYML["deploy.yml"]:::build
    end

    subgraph "Build & Deploy"
        VITEDEV["Vite Dev Server"]:::build
        VITEBUILD["Vite Build → dist/"]:::build
        INDEX["index.html"]:::build
    end

    subgraph "Client Application (Browser)"
        MAIN["src/main.jsx"]:::client
        subgraph "React SPA"
            CTREE["Components"]:::client
            PROVIDERS["Context Providers"]:::client
            HOOKS["Utility Hooks"]:::client
            STYLES["Styles (Sass)"]:::client
        end
    end

    subgraph "Static Assets / Data Layer"
        DATA["public/data/*.json"]:::data
        SECTIONS["public/data/sections/"]:::data
        IMAGES["public/images/"]:::data
        AUDIO["public/audio/"]:::data
    end

    subgraph "External Services"
        EMAILJS["EmailJS REST API"]:::external
        GHPAGES["GitHub Pages Hosting"]:::external
        LIBS["Third-Party Libraries"]:::external
    end

    FS -->|edits| PKG
    FS --> VITECFG
    FS --> NPM
    FS --> MAIN

    NPM -->|run dev| VITEDEV
    NPM -->|run build| VITEBUILD

    GHA -->|uses workflow| DEPLOYYML
    DEPLOYYML -->|build & deploy| VITEBUILD
    VITEBUILD -->|deploy| GHPAGES
    VITEDEV -->|serves| INDEX

    GHPAGES -->|serves SPA| INDEX
    INDEX -->|loads| MAIN
    MAIN --> CTREE
    MAIN --> PROVIDERS
    MAIN --> HOOKS
    MAIN --> STYLES
    MAIN --> LIBS

    CTREE -->|HTTP GET /data/*.json| DATA
    PROVIDERS -->|provide config from| DATA
    CTREE -->|use section configs| SECTIONS
    CTREE -->|load images| IMAGES
    CTREE -->|load audio| AUDIO
    CTREE -->|EmailJS API call| EMAILJS

    classDef build fill:#CCE5FF,stroke:#004085,color:#004085
    classDef client fill:#FFE5CC,stroke:#CC5500,color:#CC5500
    classDef data fill:#D4EDDA,stroke:#155724,color:#155724
    classDef external fill:#F8D7DA,stroke:#721C24,color:#721C24

    click PKG "https://github.com/ryanbalieiro/react-portfolio-template/blob/main/package.json"
    click VITECFG "https://github.com/ryanbalieiro/react-portfolio-template/blob/main/vite.config.js"
    click DEPLOYYML "https://github.com/ryanbalieiro/react-portfolio-template/blob/main/.github/workflows/deploy.yml"
    click INDEX "https://github.com/ryanbalieiro/react-portfolio-template/blob/main/index.html"
    click MAIN "https://github.com/ryanbalieiro/react-portfolio-template/blob/main/src/main.jsx"
    click CTREE "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/src/components/"
    click PROVIDERS "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/src/providers/"
    click HOOKS "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/src/hooks/"
    click STYLES "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/src/styles/"
    click DATA "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/public/data/"
    click SECTIONS "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/public/data/sections/"
    click IMAGES "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/public/images/"
    click AUDIO "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/public/audio/"
    click NPM "https://github.com/ryanbalieiro/react-portfolio-template/tree/main/npm/"
```
