# blessedzulu/portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/blessedzulu/portfolio
- Repository: https://github.com/blessedzulu/portfolio

## Overview

##### Project type and purpose
- This is a static personal portfolio website built from scratch using plain HTML, SASS/CSS and JavaScript.
- It uses GSAP for animations, Barba.js for page transitions, and Parcel as the build tool.
- The final artifacts are deployed to Netlify as a static site.

##### File structure
- Top-level files and configuration:
– package.json, package-lock.json (npm dependencies)
– .parcelrc, .postcssrc, .prettierrc, svgo.config.json (build tool configs)
– netlify.toml, static/_redirects, static/robots.txt, static/sitemap.xml (deployment configs)
- src directory (source):
– HTML pages (index.html, about.html, contact.html, etc.)
– assets (fonts, images, page-specific asset folders)
– js directory (index.js entry point for animations/transitions)
– sass directory (structured into abstracts, base, components, layout, pages, vendors)
- static directory (build output/published assets mirror)

##### README for additional insights
- Development flow:
1. npm install
2. npm start (Parcel dev server)
- Build flow (implicit): parcel build → static folder updated
- Hosting: deploy static folder to Netlify

##### Details and essential elements
- Config files feeding into the build (parcelrc, postcssrc, svgo.config)
- Asset folders and how they are processed/copied
- Optimization steps (e.g., image svg optimization, CSS autoprefixing)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Development & Build
    subgraph "Development & Build"
        direction TB
        DevEnv["Node.js & npm CLI"]:::dev
        PackageJSON["package.json"]:::dev
        PackageLock["package-lock.json"]:::dev
        ConfigFiles["Build Tool Configs"]:::dev
        ParcelRC[".parcelrc"]:::dev
        PostCSSRC[".postcssrc"]:::dev
        SVGOConfig["svgo.config.json"]:::dev
        Prettierrc[".prettierrc"]:::dev

        SourceCode["Source Code"]:::dev
        HTMLTemplates["HTML Templates"]:::dev
        JSIndex["JS Entry Point"]:::dev
        SassMain["main.scss"]:::dev
        SassAbstracts["abstracts/"]:::dev
        SassBase["base/"]:::dev
        SassComponents["components/"]:::dev
        SassLayout["layout/"]:::dev
        SassPages["pages/"]:::dev
        SassVendors["_index.scss"]:::dev
        Assets["Static Assets"]:::dev

        ParcelDev["Parcel Dev Server"]:::build
        SASSCompiler["SASS Compiler"]:::build
        PostCSS["PostCSS"]:::build
        SVGO["SVGO Optimization"]:::build
        ParcelBuild["Parcel Build"]:::build
    end

    %% Deployment & Hosting
    subgraph "Deployment & Hosting"
        direction TB
        StaticOutput["static/ (build output)"]:::deploy
        NetlifyConfig["netlify.toml"]:::deploy
        Redirects["static/_redirects"]:::deploy
        Netlify["Netlify Hosting & CDN"]:::deploy
    end

    %% Client Runtime
    subgraph "Client Runtime"
        direction TB
        Browser["Browser"]:::runtime
        Barba["Barba.js (page transitions)"]:::runtime
        GSAP["GSAP (animations)"]:::runtime
    end

    %% Connections
    DevEnv -->|uses| PackageJSON
    DevEnv -->|uses| PackageLock
    DevEnv -->|configured by| ParcelRC
    DevEnv -->|configured by| PostCSSRC
    DevEnv -->|configured by| SVGOConfig
    DevEnv -->|configured by| Prettierrc

    DevEnv --> SourceCode
    SourceCode --> HTMLTemplates
    SourceCode --> JSIndex
    SourceCode --> SassMain
    SourceCode --> Assets

    SassMain --> SassAbstracts
    SassMain --> SassBase
    SassMain --> SassComponents
    SassMain --> SassLayout
    SassMain --> SassPages
    SassMain --> SassVendors

    SourceCode -->|dev serve| ParcelDev
    SassMain -->|compile| SASSCompiler
    SassMain -->|process| PostCSS
    Assets -->|optimize| SVGO
    JSIndex --> ParcelDev
    SASSCompiler --> ParcelDev
    PostCSS --> ParcelDev
    SVGO --> ParcelDev

    ParcelDev --> Browser

    DevEnv -->|build| ParcelBuild
    SASSCompiler --> ParcelBuild
    PostCSS --> ParcelBuild
    SVGO --> ParcelBuild
    ParcelBuild --> StaticOutput

    StaticOutput -->|deploy| Netlify
    NetlifyConfig --> Netlify
    Redirects --> Netlify

    Netlify --> Browser

    Browser -->|initial load| HTMLTemplates
    Browser -->|executes| JSIndex
    Browser -->|loads| SassMain
    Browser -->|renders| Assets

    Browser --> Barba
    Barba --> GSAP
    GSAP -->|manipulate| Browser

    %% Click Events
    click PackageJSON "https://github.com/blessedzulu/portfolio/blob/main/package.json"
    click PackageLock "https://github.com/blessedzulu/portfolio/blob/main/package-lock.json"
    click ParcelRC "https://github.com/blessedzulu/portfolio/blob/main/.parcelrc"
    click PostCSSRC "https://github.com/blessedzulu/portfolio/blob/main/.postcssrc"
    click SVGOConfig "https://github.com/blessedzulu/portfolio/blob/main/svgo.config.json"
    click Prettierrc "https://github.com/blessedzulu/portfolio/blob/main/.prettierrc"
    click HTMLTemplates "https://github.com/blessedzulu/portfolio/blob/main/src/index.html"
    click HTMLTemplates "https://github.com/blessedzulu/portfolio/blob/main/src/about.html"
    click HTMLTemplates "https://github.com/blessedzulu/portfolio/blob/main/src/contact.html"
    click HTMLTemplates "https://github.com/blessedzulu/portfolio/blob/main/src/404.html"
    click HTMLTemplates "https://github.com/blessedzulu/portfolio/blob/main/src/kimgrays.html"
    click HTMLTemplates "https://github.com/blessedzulu/portfolio/blob/main/src/thank-you.html"
    click HTMLTemplates "https://github.com/blessedzulu/portfolio/blob/main/src/work.html"
    click JSIndex "https://github.com/blessedzulu/portfolio/blob/main/src/js/index.js"
    click SassMain "https://github.com/blessedzulu/portfolio/blob/main/src/sass/main.scss"
    click SassAbstracts "https://github.com/blessedzulu/portfolio/tree/main/src/sass/abstracts/"
    click SassBase "https://github.com/blessedzulu/portfolio/tree/main/src/sass/base/"
    click SassComponents "https://github.com/blessedzulu/portfolio/tree/main/src/sass/components/"
    click SassLayout "https://github.com/blessedzulu/portfolio/tree/main/src/sass/layout/"
    click SassPages "https://github.com/blessedzulu/portfolio/tree/main/src/sass/pages/"
    click SassVendors "https://github.com/blessedzulu/portfolio/blob/main/src/sass/vendors/_index.scss"
    click Assets "https://github.com/blessedzulu/portfolio/tree/main/src/assets/fonts/"
    click Assets "https://github.com/blessedzulu/portfolio/tree/main/src/assets/img/"
    click Assets "https://github.com/blessedzulu/portfolio/tree/main/src/assets/pages/404/"
    click Assets "https://github.com/blessedzulu/portfolio/tree/main/src/assets/pages/about/"
    click Assets "https://github.com/blessedzulu/portfolio/tree/main/src/assets/pages/kimgrays/"
    click Assets "https://github.com/blessedzulu/portfolio/tree/main/src/assets/pages/thank-you/"
    click StaticOutput "https://github.com/blessedzulu/portfolio/tree/main/static/"
    click Redirects "https://github.com/blessedzulu/portfolio/tree/main/static/_redirects"
    click NetlifyConfig "https://github.com/blessedzulu/portfolio/blob/main/netlify.toml"

    %% Styles
    classDef dev fill:#D0E8FF,stroke:#0366D6,stroke-width:1px
    classDef build fill:#DFF5D0,stroke:#2E8B57,stroke-width:1px
    classDef deploy fill:#FFE5B4,stroke:#CD8500,stroke-width:1px
    classDef runtime fill:#E3D0FF,stroke:#6A0DAD,stroke-width:1px
```
