# princepal/uiuxportfolio architecture

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

- Interactive diagram: https://gitdiagram.com/princepal/uiuxportfolio
- Repository: https://github.com/princepal/uiuxportfolio

## Overview

##### Project type and purpose
- This is a static-style portfolio website (UI/UX designer portfolio) implemented with PHP templates, HTML5, CSS3, and JavaScript.
- Purpose: showcase designer’s work (parallax scrolling, dark/light mode, project pages, about me, book landing).

##### File structure
- Top-level PHP pages: index.php, about-type pages (me.php, contact.php, privacy-policy.php, refund-policy.php, etc.).
- Common includes: header.php, footer.php.
- Assets folder:
- css/style.css (global styles)
- js/main.js (parallax effects, dark/light toggle)
- fonts, images, FontAwesome library.
- projects/ and services/ directories host specific project detail pages.
- .htaccess and 404.php for URL rewriting and error handling.

##### README for technical stack
- Frontend: HTML5, CSS3 (responsive, parallax design), JavaScript (dark/light mode, smooth scrolling).
- No database or server-side business logic beyond PHP includes.
- Fully responsive; assets served statically.

##### Main components & their interactions
a. Components
- Client (Browser)
- CDN or Web Server (Apache/Nginx) + PHP engine
- PHP Templates (index.php, header.php, footer.php, page-specific PHP)
- Static Assets (CSS, JS, fonts, images, FontAwesome)
- External Services (YouTube embed, LinkedIn link)
b. Relationships & Data Flow
1. User’s browser sends HTTP(S) request → Web Server
2. Server resolves URL via .htaccess → invokes PHP template
3. PHP includes header/footer + page content → compiles HTML
4. Server responds with HTML
5. Browser requests static assets (CSS/JS/fonts/images) in parallel
6. JavaScript executes client-side parallax & theme toggling
7. External embeds (YouTube) loaded via their API/iframe
c. Architectural patterns & principles
- Template include pattern (header/footer reuse)
- Static-first architecture (minimal server logic)
- Client-side enhancement (progressive enhancement for parallax & dark mode)
d. Key technologies
- PHP (templating), .htaccess (routing)
- HTML5/CSS3 (responsive design, parallax effect)
- JavaScript (interaction, theme detection)
- FontAwesome (iconography)

##### Elements
- Clear labels: Browser, Web Server (Apache+PHP), PHP Templates, Static Assets, External Services.
- Browser → Server (HTTP GET page)
- Server → Browser (HTML)
- Browser → Server (asset requests)
- Browser → External (YouTube iframe)
- Rectangles for server components (PHP engine, file system)
- Clouds for external services
- Parallelograms for client browser

##### Detailed breakdown to capture essential elements
- Files logically: “Templates” folder (header.php, footer.php, index.php, me.php, etc.).
- “Assets” bucket with sub-buckets (CSS, JS, images, fonts, FontAwesome).
- .htaccess as the routing entry point, 404.php as error handler.
- Call out dark/light theme detection in main.js.
- Responsive breakpoints in style.css.
- External embed calls (YouTube thumbnail → iframe load).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Browser
    Browser[/"User Browser"/]:::client

    %% Server Layer
    subgraph "Web Server (Apache + PHP)" 
        direction TB
        HTACCESS[".htaccess"]:::server
        PHP["PHP Engine"]:::server
        subgraph "Templates"
            direction TB
            Header["header.php"]:::template
            Footer["footer.php"]:::template
            Index["index.php"]:::template
            Me["me.php"]:::template
            Contact["contact.php"]:::template
            Privacy["privacy-policy.php"]:::template
            Refund["refund-policy.php"]:::template
            Handbook["the-ultimate-ui-ux-handbook.php"]:::template
            Error404["404.php"]:::template
            subgraph "Projects"
                direction TB
                ProjectsIndex["projects/index.php"]:::template
                B2B["projects/b2b-b2c-saas-dashboards.php"]:::template
                Fitness["projects/fitness-app-ui-design.php"]:::template
                Restaurant["projects/restaurant-booking-app-ui-ux-design-and-branding.php"]:::template
                Salon["projects/rimpi-salon-crm-brand-identity-design.php"]:::template
                Social["projects/social-networking-app-uiux.php"]:::template
                Meditation["projects/sound-based-meditation-app-branding-and-ui-ux-design.php"]:::template
            end
            subgraph "Services"
                direction TB
                ServicesIndex["services/index.php"]:::template
                ServiceB2B["services/ui-ux-design-b2b-b2c.php"]:::template
            end
        end
        subgraph "Other Files"
            direction TB
            Resume["resume.pdf"]:::server
            Sitemap["sitemap.xml"]:::server
        end
    end

    %% Assets Layer
    subgraph "Static Assets"
        direction TB
        Styles[("assets/css/style.css")]:::asset
        Scripts[("assets/js/main.js")]:::asset
        FontAwesome[("assets/fontawesome-free-6.6.0-web/")]:::asset
        Fonts[("assets/fonts/")]:::asset
        Images[("assets/images/")]:::asset
    end

    %% External Services
    subgraph "External Services"
        direction TB
        YouTube[(YouTube Iframe)]:::external
        LinkedIn[(LinkedIn)]:::external
    end

    %% Connections
    Browser -->|"HTTP GET page"| HTACCESS
    HTACCESS --> PHP
    PHP --> Templates
    Templates --> PHP
    PHP -->|HTML Response| Browser
    Browser -->|"GET CSS/JS/Images/Fonts"| Styles
    Browser --> Scripts
    Browser --> FontAwesome
    Browser --> Fonts
    Browser --> Images
    Browser --> YouTube
    Browser --> LinkedIn

    %% Click Events - Routing & Templates & Assets
    click HTACCESS "https://github.com/princepal/uiuxportfolio/blob/main/.htaccess"
    click Error404 "https://github.com/princepal/uiuxportfolio/blob/main/404.php"
    click Header "https://github.com/princepal/uiuxportfolio/blob/main/header.php"
    click Footer "https://github.com/princepal/uiuxportfolio/blob/main/footer.php"
    click Index "https://github.com/princepal/uiuxportfolio/blob/main/index.php"
    click Me "https://github.com/princepal/uiuxportfolio/blob/main/me.php"
    click Contact "https://github.com/princepal/uiuxportfolio/blob/main/contact.php"
    click Privacy "https://github.com/princepal/uiuxportfolio/blob/main/privacy-policy.php"
    click Refund "https://github.com/princepal/uiuxportfolio/blob/main/refund-policy.php"
    click Handbook "https://github.com/princepal/uiuxportfolio/blob/main/the-ultimate-ui-ux-handbook.php"
    click Resume "https://github.com/princepal/uiuxportfolio/blob/main/resume.pdf"
    click Sitemap "https://github.com/princepal/uiuxportfolio/blob/main/sitemap.xml"
    click Styles "https://github.com/princepal/uiuxportfolio/blob/main/assets/css/style.css"
    click Scripts "https://github.com/princepal/uiuxportfolio/blob/main/assets/js/main.js"
    click FontAwesome "https://github.com/princepal/uiuxportfolio/tree/main/assets/fontawesome-free-6.6.0-web/"
    click Fonts "https://github.com/princepal/uiuxportfolio/tree/main/assets/fonts/"
    click Images "https://github.com/princepal/uiuxportfolio/tree/main/assets/images/"
    click ProjectsIndex "https://github.com/princepal/uiuxportfolio/blob/main/projects/index.php"
    click B2B "https://github.com/princepal/uiuxportfolio/blob/main/projects/b2b-b2c-saas-dashboards.php"
    click Fitness "https://github.com/princepal/uiuxportfolio/blob/main/projects/fitness-app-ui-design.php"
    click Restaurant "https://github.com/princepal/uiuxportfolio/blob/main/projects/restaurant-booking-app-ui-ux-design-and-branding.php"
    click Salon "https://github.com/princepal/uiuxportfolio/blob/main/projects/rimpi-salon-crm-brand-identity-design.php"
    click Social "https://github.com/princepal/uiuxportfolio/blob/main/projects/social-networking-app-uiux.php"
    click Meditation "https://github.com/princepal/uiuxportfolio/blob/main/projects/sound-based-meditation-app-branding-and-ui-ux-design.php"
    click ServicesIndex "https://github.com/princepal/uiuxportfolio/blob/main/services/index.php"
    click ServiceB2B "https://github.com/princepal/uiuxportfolio/blob/main/services/ui-ux-design-b2b-b2c.php"

    %% Styles
    classDef client fill:#E0F7FA,stroke:#0277BD,color:#000
    classDef server fill:#E1F5FE,stroke:#0288D1,color:#000
    classDef template fill:#FFF3E0,stroke:#FB8C00,color:#000
    classDef asset fill:#E8F5E9,stroke:#43A047,color:#000
    classDef external fill:#F3E5F5,stroke:#8E24AA,color:#000
```
