# shegezzy/olusegun-akinnola-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/shegezzy/olusegun-akinnola-portfolio
- Repository: https://github.com/shegezzy/olusegun-akinnola-portfolio

## Overview

##### Main Components
- Web Pages: The core HTML files (index.html, 404.html) that serve as the entry points.
- Assets: This includes subdirectories for CSS (styles.css), JavaScript (main.js), images (favicons, portfolio images, skills, etc.), and PDFs (resumes/CVs, etc.).
- Public Folder Components: Files present in the public folder, including a copy of assets, manifest.json (for PWA configuration), and serviceworker.js to enable offline functionality.
- Service Worker: There are serviceworker.js files (both at the root and in public) that enable a progressive web app (PWA) experience.

##### Visualizing Relationships and Interactions
- Central Component: The web pages (index.html and 404.html) are the primary entry points.
- Asset Loading: Illustrate that the HTML pages load CSS, JavaScript, and image assets from the assets (or public/assets) folder.
- PWA Enhancements: Show that the manifest.json and serviceworker.js work in tandem to support offline capabilities and potentially caching behavior.
- Static Contenting: Emphasize that this project doesn’t have dynamic server-side components; rather, it is designed as a static site with prebuilt resources ready for deployment.

##### Architectural Patterns/Design Principles
- Separation of Concerns: Clearly separate the static content (HTML/CSS/JS) from the service worker and PWA support files.
- Progressive Enhancement: The inclusion of a service worker and manifest supports a mobile-first and offline-capable design.
- Asset Organization: The structure indicates a logical separation of assets (CSS, JS, images, etc.), which reflects good practices in asset management for static sites.

##### Relevant Technologies
- HTML, CSS, JavaScript: Core technologies for building the front end.
- Service Workers & Web Manifest: Key for enabling PWA features.
- No Backend or Database: Since this is a static portfolio website, focus on the client-side architecture.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Browser(["Browser"]):::external

    subgraph "HTML Pages"
        indexPage("index.html: Main landing page"):::static
        page404("404.html: Fallback error page"):::static
    end

    subgraph "Assets"
        subgraph "CSS Assets"
            css_assets("styles.css (assets)"):::static
            css_public("styles.css (public)"):::static
        end
        subgraph "JavaScript Assets"
            js_assets("main.js (assets)"):::static
            js_public("main.js (public)"):::static
        end
        subgraph "Media Assets"
            img("Image Assets"):::static
            pdf("PDF Assets"):::static
        end
    end

    subgraph "PWA Components"
        manifest("manifest.json"):::pwa
        sw_public("serviceworker.js (public)"):::pwa
        sw_root("serviceworker.js (root)"):::pwa
    end

    Browser -->|"Loads"| indexPage
    Browser -->|"FallbackHits"| page404

    indexPage -->|"LoadsCSS"| css_assets
    indexPage -->|"LoadsJS"| js_assets
    indexPage -->|"LoadsMedia"| img
    indexPage -->|"LoadsMedia"| pdf
    indexPage -->|"RegistersManifest"| manifest
    indexPage -->|"RegistersSW"| sw_public

    js_assets -->|"RegistersSW"| sw_root

    sw_public -->|"CachesCSS"| css_public
    sw_public -->|"CachesJS"| js_public
    sw_public -->|"CachesMedia"| img
    sw_public -->|"CachesMedia"| pdf
    sw_root -->|"CachesPage"| indexPage

    click indexPage "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/index.html"
    click page404 "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/public/404.html"
    click css_assets "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/assets/css/styles.css"
    click css_public "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/public/assets/css/styles.css"
    click js_assets "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/assets/js/main.js"
    click js_public "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/public/assets/js/main.js"
    click img "https://github.com/shegezzy/olusegun-akinnola-portfolio/tree/master/assets/img/"
    click pdf "https://github.com/shegezzy/olusegun-akinnola-portfolio/tree/master/assets/pdf/"
    click manifest "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/public/manifest.json"
    click sw_public "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/public/serviceworker.js"
    click sw_root "https://github.com/shegezzy/olusegun-akinnola-portfolio/blob/master/serviceworker.js"

    classDef external fill:#cfc,stroke:#333,stroke-width:2px;
    classDef static fill:#f9f,stroke:#333,stroke-width:2px;
    classDef pwa fill:#ccf,stroke:#333,stroke-width:2px;
```
