# oowais/yet-another-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/oowais/yet-another-portfolio
- Repository: https://github.com/oowais/yet-another-portfolio

## Overview

**Client Layer (Browser) → Nuxt Application Layer → Server Layer**

##### Detailed Component Breakdown

A. Client-Side Components:
- Home (index.vue)
- Education (education.vue)
- Work (work.vue)

- Navigation Components
- Sidenav
- VerticalNav
- Feature Components
- ThemeSwitch
- SkillsCard
- Project Components
- Project Card
- Work Components
- Work Card

B. Application Core:
- Configuration Layer
- app.config.ts
- nuxt.config.ts
- tailwind.config.ts

- Asset Management
- CSS (Tailwind)
- Static Assets

C. Server Layer:
- Server Configuration
- API Routes (if any)

##### Key Relationships to Highlight

- How pages utilize shared components
- Theme switching mechanism
- Demonstrate the relationship between Tailwind CSS and components
- How the server handles requests

##### Technical Stack Indicators

Badges or labels for:
- Nuxt 3
- Vue.js
- Tailwind CSS
- TypeScript

##### Specific Implementation Details

- Component hierarchy
- Routing flow
- Asset pipeline
- Build process

- The component-based architecture
- The clear separation between pages and reusable components
- The configuration system
- The static asset handling

Remember to:
- Notes about key architectural decisions

For this specific Nuxt 3 application, focus on:
- The single-page application (SPA) nature
- The component reusability pattern
- The theming system implementation
- The static site generation capabilities

- How components are organized and reused
- How the routing system works
- How the theming system is implemented
- How the build process transforms the application

A small section showing the development and production deployment flows, as mentioned in the README.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph "Nuxt Application"
        subgraph "Pages"
            Home["Home Page"]:::page
            Education["Education Page"]:::page
            Work["Work Page"]:::page
        end

        subgraph "Layouts"
            DefaultLayout["Default Layout"]:::component
        end

        subgraph "Components"
            direction TB
            subgraph "Navigation"
                Sidenav["Side Navigation"]:::component
                VerticalNav["Vertical Navigation"]:::component
            end

            subgraph "Features"
                ThemeSwitch["Theme Switcher"]:::component
                SkillsCard["Skills Card"]:::component
            end

            subgraph "Content"
                ProjectCard["Project Card"]:::component
                WorkCard["Work Card"]:::component
            end
        end

        subgraph "Configuration"
            AppConfig["Application Config"]:::config
            NuxtConfig["Nuxt Config"]:::config
            TailwindConfig["Tailwind Config"]:::config
        end

        subgraph "Assets"
            CSS["Tailwind CSS"]:::asset
            Types["Type Definitions"]:::asset
        end
    end

    subgraph "Server"
        ServerConfig["Server Configuration"]:::server
    end

    %% Relationships
    Browser --> Home
    Browser --> Education
    Browser --> Work

    Home --> DefaultLayout
    Education --> DefaultLayout
    Work --> DefaultLayout

    DefaultLayout --> Sidenav
    DefaultLayout --> VerticalNav
    DefaultLayout --> ThemeSwitch

    Home --> SkillsCard
    Home --> ProjectCard
    Work --> WorkCard

    AppConfig --> DefaultLayout
    NuxtConfig --> DefaultLayout
    TailwindConfig --> CSS
    CSS --> DefaultLayout

    %% Click Events
    click Home "https://github.com/oowais/Yet-another-portfolio/blob/main/pages/index.vue"
    click Education "https://github.com/oowais/Yet-another-portfolio/blob/main/pages/education.vue"
    click Work "https://github.com/oowais/Yet-another-portfolio/blob/main/pages/work.vue"
    click Sidenav "https://github.com/oowais/Yet-another-portfolio/blob/main/components/sidenav.vue"
    click VerticalNav "https://github.com/oowais/Yet-another-portfolio/blob/main/components/verticalNav.vue"
    click ThemeSwitch "https://github.com/oowais/Yet-another-portfolio/blob/main/components/themeSwitch.vue"
    click SkillsCard "https://github.com/oowais/Yet-another-portfolio/blob/main/components/skillsCard.vue"
    click ProjectCard "https://github.com/oowais/Yet-another-portfolio/blob/main/components/projects/Card.vue"
    click WorkCard "https://github.com/oowais/Yet-another-portfolio/blob/main/components/work/card.vue"
    click DefaultLayout "https://github.com/oowais/Yet-another-portfolio/blob/main/layouts/default.vue"
    click AppConfig "https://github.com/oowais/Yet-another-portfolio/blob/main/app.config.ts"
    click NuxtConfig "https://github.com/oowais/Yet-another-portfolio/blob/main/nuxt.config.ts"
    click TailwindConfig "https://github.com/oowais/Yet-another-portfolio/blob/main/tailwind.config.ts"
    click CSS "https://github.com/oowais/Yet-another-portfolio/blob/main/assets/css/tailwind.css"
    click ServerConfig "https://github.com/oowais/Yet-another-portfolio/blob/main/server/tsconfig.json"
    click Types "https://github.com/oowais/Yet-another-portfolio/blob/main/utils/types.ts"

    %% Styles
    classDef page fill:#e1f5fe,stroke:#01579b
    classDef component fill:#e8f5e9,stroke:#2e7d32
    classDef config fill:#fff3e0,stroke:#ff6f00
    classDef asset fill:#f3e5f5,stroke:#7b1fa2
    classDef server fill:#fbe9e7,stroke:#d84315

    %% Legend
    subgraph Legend
        L1["Page"]:::page
        L2["Component"]:::component
        L3["Configuration"]:::config
        L4["Asset"]:::asset
        L5["Server"]:::server
    end
```
