# didoslavov/my-portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/didoslavov/my-portfolio
- Repository: https://github.com/didoslavov/my-portfolio

## Overview

##### Main Components

A. Frontend Layer:
- Next.js Application (Core)
- Pages/Routes (/about, /contact, /guest-book, /projects)
- Components (UI, Layout)
- Client-side Features (Theme switching, animations)

B. Backend Services:
- Hasura GraphQL Engine
- Metadata configuration
- Database connections
- Next.js API Routes (/api/email)

C. External Services:
- GitHub API Integration (based on github-api.ts)
- Email Service (based on send-email.ts)

**[Client Layer]**
- ↕
**[Application Layer]**
- ↕
**[Data Layer]**

##### Component Relationships

- Client-Server communication via GraphQL (frontend → Hasura)
- API Routes handling (frontend → Next.js API)
- External service interactions (application → GitHub API, Email Service)

##### Detailed Component Breakdown

Frontend (Next.js):
**[Pages] → [Components] → [UI Elements]**
- ↓          ↓             ↓
**[Layouts] → [Providers] → [Utils/Animations]**

Backend:
**[Hasura GraphQL Engine]**
- ↓
**[Database Connections]**
- ↓
**[Metadata Configuration]**

##### Technical Stack Indicators

Technology badges for:
- Next.js
- TypeScript
- Tailwind CSS
- GraphQL
- Hasura
- GitHub API

##### Data Flow Representation

- Client-side data fetching
- Server-side API calls
- GraphQL mutations and queries
- Email service integration
- GitHub API interactions

##### Additional Elements

Include:
- Version information
- Environment configurations
- Build/Deploy pipeline indicators

- High-level architecture visibility
- Detailed component relationships
- Clear data flow patterns
- Technology stack integration

Remember to:
- Use consistent styling
- A clear hierarchy of components
- Both synchronous and asynchronous communications
- Security boundaries
- Public vs. private routes

This system design should effectively communicate the portfolio website's architecture while showing the integration of various services and features in a clear, professional manner.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Pages["Pages/Routes"]
        Components["UI Components"]
        Layout["Layout Components"]
        Theme["Theme System"]
        Animations["Animation System"]
    end

    subgraph Backend
        HasuraEngine["Hasura GraphQL Engine"]
        NextAPI["Next.js API Routes"]
        Database[(Database)]
    end

    subgraph External
        GitHub["GitHub API"]
        EmailService["Email Service"]
    end

    %% Component Relationships
    Pages --> Components
    Pages --> Layout
    Layout --> Theme
    Components --> Animations
    
    %% Backend Connections
    HasuraEngine --> Database
    Pages --> HasuraEngine
    Pages --> NextAPI
    NextAPI --> EmailService
    Pages --> GitHub

    %% Special Features
    ShootingStars["Shooting Stars"]
    SocialLinks["Social Links"]
    Components --> ShootingStars
    Components --> SocialLinks

    %% Styling
    classDef frontend fill:#3b82f6,color:#fff
    classDef backend fill:#22c55e,color:#fff
    classDef external fill:#a855f7,color:#fff
    classDef database fill:#f97316,color:#fff
    classDef feature fill:#64748b,color:#fff

    class Pages,Components,Layout,Theme,Animations frontend
    class HasuraEngine,NextAPI backend
    class GitHub,EmailService external
    class Database database
    class ShootingStars,SocialLinks feature

    %% Click Events
    click Pages "https://github.com/didoslavov/My-Portfolio/tree/main/src/app/"
    click Components "https://github.com/didoslavov/My-Portfolio/tree/main/src/components/ui/"
    click Layout "https://github.com/didoslavov/My-Portfolio/tree/main/src/components/layout/"
    click Theme "https://github.com/didoslavov/My-Portfolio/blob/main/src/components/layout/header/theme-button.tsx"
    click Animations "https://github.com/didoslavov/My-Portfolio/tree/main/src/utils/animations/"
    click HasuraEngine "https://github.com/didoslavov/My-Portfolio/blob/main/hasura/config.yaml"
    click NextAPI "https://github.com/didoslavov/My-Portfolio/tree/main/src/app/api/"
    click GitHub "https://github.com/didoslavov/My-Portfolio/blob/main/src/lib/github-api.ts"
    click EmailService "https://github.com/didoslavov/My-Portfolio/blob/main/src/lib/send-email.ts"
    click ShootingStars "https://github.com/didoslavov/My-Portfolio/tree/main/src/components/ui/shooting-stars/"
    click SocialLinks "https://github.com/didoslavov/My-Portfolio/blob/main/src/components/ui/socials.tsx"

    %% Legend
    subgraph Legend
        Frontend["Frontend Component"]:::frontend
        BackendComp["Backend Component"]:::backend
        ExternalComp["External Service"]:::external
        DatabaseComp["Database"]:::database
        FeatureComp["Special Feature"]:::feature
    end
```
