# mrodriguez360/swift-bizcard architecture

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

- Interactive diagram: https://gitdiagram.com/mrodriguez360/swift-bizcard
- Repository: https://github.com/mrodriguez360/swift-bizcard

## Overview

##### Project type and purpose
- This is a single-page application (SPA) front-end built with React, Vite, TypeScript, Tailwind CSS and the shadcn-ui component library.
- Its purpose is to render a personal portfolio (projects, certifications, experience) as a static site, served and deployed via the Lovable platform.

##### File structure
- Top‐level:
- config files (tsconfig, vite.config.ts, tailwind.config.ts, eslint.config.js)
- package.json / lockfiles
- public/ (robots.txt, static uploads, index.html)
- src/
– main.tsx, index.css (entry point + global styles)
– App.tsx / App.css (root component)
– pages/ (Index.tsx, NotFound.tsx → client-side routing)
– components/
· ui/ (primitive UI building blocks from shadcn-ui)
· portfolio/ (CertificationBar, ProfilePanel, ProjectGrid, ExperienceHighlights)
· InteractiveBackground, Typewriter
– hooks/ (useMobile, useToast)
– lib/ (utils)
– content/ (static JSON/TS content for portfolio)
- No backend code—data is static or embedded.

##### README
- Confirms tech stack (Vite + TS + React + shadcn-ui + Tailwind).
- Deployment via Lovable (automated CI/CD of static assets).
- No runtime API calls or database dependencies mentioned.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer & CI/CD Pipeline
    subgraph "Developer & CI/CD"
        Dev["Developer (IDE, Git)"]:::pipeline
        GitHub["Source Code Repo (GitHub)"]:::pipeline
        subgraph "Build System"
            ViteConfig["vite.config.ts"]:::pipeline
            TSConfig["tsconfig.json"]:::pipeline
            TailwindConfig["tailwind.config.ts"]:::pipeline
            PostCSSConf["postcss.config.js"]:::pipeline
            PackageJSON["package.json"]:::pipeline
            BuildSys["Vite & npm Scripts"]:::pipeline
            ViteConfig --> BuildSys
            TSConfig --> BuildSys
            TailwindConfig --> BuildSys
            PostCSSConf --> BuildSys
            PackageJSON --> BuildSys
        end
        GitHub -->|"CI Trigger"| BuildSys
        BuildSys -->|"deploy"| Lovable["Lovable Hosting"]:::pipeline
        Lovable --> CDN["CDN"]:::pipeline
        Dev -->|"push"| GitHub
    end

    %% Browser Runtime
    CDN --> Browser["Browser (SPA Runtime)"]:::runtime

    subgraph "Client Entry Point"
        IndexHTML["index.html"]:::runtime
        MainTS["src/main.tsx"]:::runtime
        IndexCSS["src/index.css"]:::runtime
    end
    Browser --> IndexHTML
    Browser --> MainTS
    Browser --> IndexCSS

    %% Static Assets & Content
    subgraph "Static Assets"
        AssetsDir["src/assets"]:::static
        subgraph public
            Robots["robots.txt"]:::static
            LovableUploads["lovable-uploads"]:::static
        end
    end
    AssetsDir --> CDN
    public --> CDN

    %% Application Structure
    MainTS --> AppComp["src/App.tsx"]:::runtime
    IndexHTML --> AppComp
    IndexCSS --> AppComp

    subgraph "Application Layers"
        AppComp
        subgraph "Pages (Routing)"
            IndexPage["src/pages/Index.tsx"]:::runtime
            NotFoundPage["src/pages/NotFound.tsx"]:::runtime
        end
        subgraph "Feature Layer"
            CertBar["src/components/portfolio/CertificationBar.tsx"]:::component
            ProfilePanel["src/components/portfolio/ProfilePanel.tsx"]:::component
            ProjectGrid["src/components/portfolio/ProjectGrid.tsx"]:::component
            Experience["src/components/portfolio/ExperienceHighlights.tsx"]:::component
        end
        subgraph "Design System Layer"
            Accordion["src/components/ui/accordion.tsx"]:::component
            Button["src/components/ui/button.tsx"]:::component
        end
        subgraph "Interactive UI Components"
            InteractiveBG["src/components/InteractiveBackground.tsx"]:::component
            Typewriter["src/components/Typewriter.tsx"]:::component
        end
        subgraph "Custom Hooks"
            UseMobile["src/hooks/use-mobile.tsx"]:::component
            UseToast["src/hooks/use-toast.ts"]:::component
        end
        Utils["src/lib/utils.ts"]:::component
        Content["src/content/portfolio.ts"]:::static
    end

    %% Component Relationships
    AppComp --> IndexPage
    AppComp --> NotFoundPage
    AppComp --> CertBar
    AppComp --> ProfilePanel
    AppComp --> ProjectGrid
    AppComp --> Experience
    AppComp --> Accordion
    AppComp --> Button
    AppComp --> InteractiveBG
    AppComp --> Typewriter
    AppComp --> UseMobile
    AppComp --> UseToast
    AppComp --> Utils
    AppComp --> Content

    CertBar --> Content
    ProfilePanel --> Content
    ProjectGrid --> Content
    Experience --> Content

    %% Click Events
    click ViteConfig "https://github.com/mrodriguez360/swift-bizcard/blob/main/vite.config.ts"
    click TSConfig "https://github.com/mrodriguez360/swift-bizcard/blob/main/tsconfig.json"
    click TailwindConfig "https://github.com/mrodriguez360/swift-bizcard/blob/main/tailwind.config.ts"
    click PostCSSConf "https://github.com/mrodriguez360/swift-bizcard/blob/main/postcss.config.js"
    click PackageJSON "https://github.com/mrodriguez360/swift-bizcard/blob/main/package.json"
    click MainTS "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/main.tsx"
    click IndexCSS "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/index.css"
    click IndexHTML "https://github.com/mrodriguez360/swift-bizcard/blob/main/index.html"
    click AppComp "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/App.tsx"
    click IndexPage "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/pages/Index.tsx"
    click NotFoundPage "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/pages/NotFound.tsx"
    click Accordion "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/ui/accordion.tsx"
    click Button "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/ui/button.tsx"
    click CertBar "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/portfolio/CertificationBar.tsx"
    click ProfilePanel "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/portfolio/ProfilePanel.tsx"
    click ProjectGrid "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/portfolio/ProjectGrid.tsx"
    click Experience "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/portfolio/ExperienceHighlights.tsx"
    click InteractiveBG "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/InteractiveBackground.tsx"
    click Typewriter "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/components/Typewriter.tsx"
    click UseMobile "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/hooks/use-mobile.tsx"
    click UseToast "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/hooks/use-toast.ts"
    click Utils "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/lib/utils.ts"
    click Content "https://github.com/mrodriguez360/swift-bizcard/blob/main/src/content/portfolio.ts"
    click AssetsDir "https://github.com/mrodriguez360/swift-bizcard/tree/main/src/assets"
    click Robots "https://github.com/mrodriguez360/swift-bizcard/blob/main/public/robots.txt"
    click LovableUploads "https://github.com/mrodriguez360/swift-bizcard/tree/main/public/lovable-uploads"

    %% Styles
    classDef pipeline fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef runtime fill:#DFF7D0,stroke:#28a745,color:#28a745
    classDef static fill:#FFF5C2,stroke:#dbab09,color:#dbab09
    classDef component fill:#E8E8E8,stroke:#636363,color:#333
```
