# fouziya-1903/fouziya-portfolio architecture

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

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

## Overview

##### Project Type and Purpose
- This is a **static single-page application (SPA)** built with Vite, TypeScript, React, shadcn-ui and Tailwind CSS.
- No backend API or database—everything runs in the browser.

##### File Structure
- Top-level files:
- package.json, tsconfig*, vite.config.ts, tailwind.config.ts (build & config)
- public/index.html, public/robots.txt (static assets)
- src/ contains:
- main.tsx + App.tsx (entry point & root component)
- components/ (About, Projects, Contact, plus UI primitives from shadcn-ui)
- pages/ (Index.tsx, NotFound.tsx)
- hooks/, lib/utils.ts (custom hooks & utilities)
- styles (App.css, index.css)
- No server/ backend folder—this is pure front end.

##### README
- Confirms tech stack and deployment via Lovable (static hosting).
- No external API or data store mentioned.

##### Main Components
a. **Developer Environment**
- IDE (local)
- Git repository (push/pull via GitHub & Lovable)
b. **Build Pipeline**
- Vite (bundler / dev server)
- PostCSS / Tailwind / TypeScript compiler
c. **Static Hosting**
- Lovable platform (publishes to CDN)
d. **Runtime in Browser**
- index.html + JS bundles
- React app (App → pages → components → UI library)

##### Relationships & Data Flow
- Developer commits code → Git repo → triggers (optional) CI or direct Lovable sync
- Vite bundler (locally or in Lovable) processes src/ + public/ → static assets
- Assets deployed to CDN (Lovable)
- End user’s browser requests index.html → loads JS/CSS → React hydrates UI
- No API calls or backend interactions

##### Architectural Patterns & Design Principles
- **SPA**: single entry point (index.html → main.tsx)
- **Component-based**: functional React components + custom hooks
- **Utility-first CSS**: Tailwind for styling
- **Design system**: shadcn-ui primitives in src/components/ui
- **Folder segregation**: pages vs. components vs. ui primitives vs. hooks vs. lib

##### Technologies & Frameworks to Annotate
- Vite (dev server / bundler)
- React + TypeScript
- Tailwind CSS + PostCSS
- shadcn-ui component library
- Lovable static hosting / CDN

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    Developer(("Developer / IDE")):::actor
    Browser(("Browser")):::actor

    %% Build & Deployment
    subgraph "Source Control & CI/CD"
        GitRepo[("Git Repository")]:::storage
    end

    subgraph "Build Pipeline"
        Vite["Vite Bundler\n(dev server & build)"]:::process
        Tailwind["Tailwind CSS / PostCSS"]:::process
        TypeScript["TypeScript Compiler"]:::process
        ConfigFiles["Build Configurations\n(vite.config.ts,\ntsconfig*.json,\neslint.config.js,\npackage.json)"]:::config
        PublicAssets["Public Assets\n(public/index.html,\npublic/robots.txt)"]:::assets
    end

    subgraph "Runtime in Browser"
        ReactApp["React Application"]:::process
        subgraph "React App Structure"
            App["App.tsx"]:::component
            Pages["Pages"]:::module
            Components["Feature Components"]:::module
            UIPrimitives["UI Primitives\n(shadcn-ui)"]:::module
            Hooks["Custom Hooks & Utils"]:::module
            Styles["Styles\n(index.css, App.css)"]:::module
        end
    end

    CDN[("Lovable CDN / Static Hosting")]:::storage

    %% Relationships
    Developer -->|push code| GitRepo
    GitRepo -->|trigger build| Vite
    Vite -->|process CSS| Tailwind
    Vite -->|compile TS| TypeScript
    Vite -->|use configs| ConfigFiles
    Vite -->|bundle static| PublicAssets
    Vite -->|output static site| CDN
    CDN -->|serve assets| Browser
    Browser -->|load index.html| PublicAssets
    Browser -->|load JS/CSS| ReactApp
    ReactApp --> App
    App --> Pages
    App --> Components
    Components --> UIPrimitives
    App --> Hooks
    App --> Styles

    %% Click Events
    click PublicAssets "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/public/index.html"
    click App "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/App.tsx"
    click Pages "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/pages/Index.tsx"
    click Pages "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/pages/NotFound.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/About.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Achievements.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Certifications.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Contact.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Education.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Hero.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Projects.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Sidebar.tsx"
    click Components "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/components/Skills.tsx"
    click UIPrimitives "https://github.com/fouziya-1903/fouziya-portfolio/tree/main/src/components/ui"
    click Hooks "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/hooks/use-mobile.tsx"
    click Hooks "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/hooks/use-toast.ts"
    click Hooks "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/lib/utils.ts"
    click Styles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/index.css"
    click Styles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/src/App.css"
    click ConfigFiles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/vite.config.ts"
    click ConfigFiles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/tsconfig.json"
    click ConfigFiles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/tsconfig.app.json"
    click ConfigFiles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/tsconfig.node.json"
    click ConfigFiles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/eslint.config.js"
    click ConfigFiles "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/package.json"
    click CDN "https://github.com/fouziya-1903/fouziya-portfolio/blob/main/public/robots.txt"

    %% Styles
    classDef actor fill:#f9f,stroke:#333,stroke-width:2px
    classDef process fill:#bbf,stroke:#333,stroke-width:1px
    classDef storage fill:#bfb,stroke:#333,stroke-width:1px
    classDef config fill:#ffb,stroke:#333,stroke-width:1px
    classDef assets fill:#fbf,stroke:#333,stroke-width:1px
    classDef component fill:#eef,stroke:#333,stroke-width:1px
    classDef module fill:#efe,stroke:#333,stroke-width:1px
```
