# youzri/ahmedyousriportofolio architecture

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

- Interactive diagram: https://gitdiagram.com/youzri/ahmedyousriportofolio
- Repository: https://github.com/youzri/ahmedyousriportofolio

## Overview

##### Project type and purpose
- This is a single-page front-end web application built with Vite, TypeScript, React, shadcn-ui and Tailwind CSS.
- It has no custom backend code; it’s intended to be deployed as a static site (e.g., via Lovable’s hosting).

##### File structure
- Top-level assets:
- index.html – entry point served to the browser
- css/styles.css, js/booking.js, js/main.js – legacy or additional static assets
- public/robots.txt – static file copied verbatim
- Source code (src/):
- main.tsx – bootstraps React app via Vite dev server
- index.css & tailwind.config.ts / postcss.config.js – Tailwind CSS pipeline
- components/ui/ – all presentational shadcn-ui wrappers and custom components
- hooks/ – shared React hooks (useMobile, useToast)
- lib/ – utility functions (utils.ts)
- pages/ – React Router pages (Index, NotFound)
- Tooling & config:
- vite.config.ts – Vite build & dev server settings
- tsconfig*.json – TypeScript config
- package.json / bun.lockb – dependencies & scripts
- eslint.config.js – linting rules

##### README for additional insights
- Confirms tech stack: Vite, TypeScript, React, shadcn-ui, Tailwind CSS
- Deployment via Lovable (static hosting with optional custom domains)
- Development: clone, npm i, npm run dev

##### Diagramming recommendations
- Use clear, concise labels for each component (e.g., “Vite Dev Server”, “React App (src/)”, “Lovable CDN”)
- Code push → Build
- Build → Deployment
- Browser → CDN → Browser loads assets
- React App → Hooks / UI Components
- CI/CD & Build (Vite, Tailwind) – another
- Hosting & CDN – another
- Client Runtime (Browser, React) – another

##### Detail
1. Entry Point (index.html)
2. Asset Pipeline (Tailwind, PostCSS)
3. Bundler (Vite)
4. React App (main.tsx → pages & components/ui & hooks & lib)
5. Hosting (Lovable)
6. Client Browser

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Developer Environment
  subgraph "Developer Environment"
    IDE["IDE / Code Editor"]:::devtools
    Git["Git Repository"]:::devtools
    Node["Node.js & npm"]:::devtools
  end

  IDE -->|commits code| Git
  Node -->|runs scripts| IDE

  %% CI/CD & Build
  subgraph "CI/CD & Build Pipeline"
    GitHub["GitHub / Lovable Git"]:::cicd
    ViteServer["Vite Dev Server / Bundler"]:::build
    TypeScript["TypeScript Compiler"]:::build
    PostCSS["PostCSS & Tailwind CSS"]:::build
    Bundler["esbuild/Rollup Bundler"]:::build
  end

  Git -->|push triggers| GitHub
  GitHub -->|starts build| ViteServer
  ViteServer -->|compiles TS| TypeScript
  ViteServer -->|processes CSS| PostCSS
  ViteServer -->|bundles assets| Bundler

  %% Deployment
  subgraph "Deployment & Hosting"
    Artifacts["Build Artifacts (dist/)"]:::deploy
    CDN["Lovable CDN / Static Hosting"]:::deploy
    DNS["Custom Domain & DNS"]:::deploy
  end

  Bundler -->|outputs| Artifacts
  Artifacts -->|deploy to| CDN
  DNS -->|routes to| CDN

  %% Client Runtime
  subgraph "Client (Browser)"
    Browser["Web Browser"]:::client
    HTML["Entry Point: index.html"]:::client
    StaticAssets["Static Assets (CSS/JS)"]:::client
    ReactApp["React App"]:::client
    Router["React Router (pages/)"]:::client
    UIComp["UI Components (shadcn-ui)"]:::client
    Hooks["Hooks & Utils"]:::client
    Utils["Utility Functions"]:::client
  end

  CDN -->|serves| Browser
  Browser -->|loads| HTML
  Browser -->|loads| StaticAssets
  HTML -->|bootstraps| ReactApp
  StaticAssets -->|styles & scripts| ReactApp
  ReactApp -->|renders| Router
  ReactApp -->|uses| UIComp
  ReactApp -->|uses| Hooks
  Hooks -->|imports| Utils

  %% Click Events
  click HTML "https://github.com/youzri/ahmedyousriportofolio/blob/main/index.html"
  click StaticAssets "https://github.com/youzri/ahmedyousriportofolio/blob/main/css/styles.css"
  click StaticAssets "https://github.com/youzri/ahmedyousriportofolio/blob/main/js/booking.js"
  click StaticAssets "https://github.com/youzri/ahmedyousriportofolio/blob/main/js/main.js"
  click StaticAssets "https://github.com/youzri/ahmedyousriportofolio/blob/main/public/robots.txt"
  click PostCSS "https://github.com/youzri/ahmedyousriportofolio/blob/main/tailwind.config.ts"
  click PostCSS "https://github.com/youzri/ahmedyousriportofolio/blob/main/postcss.config.js"
  click Browser "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/index.css"
  click ViteServer "https://github.com/youzri/ahmedyousriportofolio/blob/main/vite.config.ts"
  click ViteServer "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/vite-env.d.ts"
  click ReactApp "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/main.tsx"
  click ReactApp "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/App.tsx"
  click StaticAssets "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/App.css"
  click Router "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/pages/Index.tsx"
  click Router "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/pages/NotFound.tsx"
  click UIComp "https://github.com/youzri/ahmedyousriportofolio/tree/main/src/components/ui/"
  click UIComp "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/components/ui/use-toast.ts"
  click Hooks "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/hooks/use-mobile.tsx"
  click Hooks "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/hooks/use-toast.ts"
  click Utils "https://github.com/youzri/ahmedyousriportofolio/blob/main/src/lib/utils.ts"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/package.json"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/package-lock.json"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/bun.lockb"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/tsconfig.json"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/tsconfig.app.json"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/tsconfig.node.json"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/eslint.config.js"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/components.json"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/README.md"
  click Git "https://github.com/youzri/ahmedyousriportofolio/blob/main/.gitignore"

  %% Styles
  classDef devtools fill:#f9f,stroke:#333,stroke-width:1px
  classDef cicd fill:#ff9,stroke:#333,stroke-width:1px
  classDef build fill:#9ff,stroke:#333,stroke-width:1px
  classDef deploy fill:#cfc,stroke:#333,stroke-width:1px
  classDef client fill:#fc9,stroke:#333,stroke-width:1px
```
