# karolczaq/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a full-stack, content-driven web application built with Next.js (App Router).
- It serves as a personal/portfolio site that fetches project and skill data from a headless CMS (Sanity).
- The “/admin” route likely hosts the Sanity Studio for content management, while the rest of the site is statically and server-side rendered for visitors.

##### File structure
- Top-level:
- next.config.ts, tsconfig.json, ESlint/postcss configs – build and linting setup.
- public/ – static assets and images.
- sanity.config.ts + src/sanity/… – configuration and schemas for Sanity CMS.
- Source code under src/:
- src/app/ – Next.js App Router pages and API routes.
– app/page.tsx, layout.tsx – entry points for SSR/SSG.
– app/api/getProjects/route.ts & getSkills/route.ts – server functions exposing “/api” endpoints.
– app/admin/page.tsx – embedded Sanity Studio or admin UI.
- src/components/ – reusable React components (Navbar, Projects, Skills, etc.).
- src/hooks/ – custom hooks for scroll, mobile detection, UI stages.
- src/lib/ & src/utils/ – helper functions, constants, social links.

##### README for additional insights
- Standard create-next-app boilerplate; no custom architecture docs.
- Deployment target is Vercel (implies serverless functions for API routes and static hosting for the public folder).

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Client (Browser)" 
        Browser["Browser Client"]:::frontend
    end

    subgraph "Frontend (Next.js Client)"
        Components["React Components"]:::frontend
        click Components "https://github.com/karolczaq/portfolio/tree/main/src/components/"
        Navbar["Navbar"]:::frontend
        click Navbar "https://github.com/karolczaq/portfolio/blob/main/src/components/Navbar.tsx"
        NavbarItem["NavbarItem"]:::frontend
        click NavbarItem "https://github.com/karolczaq/portfolio/blob/main/src/components/NavbarItem.tsx"
        ProjectsOverview["Projects"]:::frontend
        click ProjectsOverview "https://github.com/karolczaq/portfolio/blob/main/src/components/Projects.tsx"
        ProjectContainer["ProjectContainer"]:::frontend
        click ProjectContainer "https://github.com/karolczaq/portfolio/blob/main/src/components/Projects/ProjectContainer.tsx"
        ProjectFrame["ProjectFrame"]:::frontend
        click ProjectFrame "https://github.com/karolczaq/portfolio/blob/main/src/components/Projects/ProjectFrame.tsx"
        ProjectHeader["ProjectHeader"]:::frontend
        click ProjectHeader "https://github.com/karolczaq/portfolio/blob/main/src/components/Projects/ProjectHeader.tsx"
        ProjectReadme["ProjectReadme"]:::frontend
        click ProjectReadme "https://github.com/karolczaq/portfolio/blob/main/src/components/Projects/ProjectReadme.tsx"
        SkillsOverview["Skills"]:::frontend
        click SkillsOverview "https://github.com/karolczaq/portfolio/blob/main/src/components/Skills.tsx"
        SkillContainer["SkillContainer"]:::frontend
        click SkillContainer "https://github.com/karolczaq/portfolio/blob/main/src/components/Skills/SkillContainer.tsx"
        SkillImage["SkillImage"]:::frontend
        click SkillImage "https://github.com/karolczaq/portfolio/blob/main/src/components/Skills/SkillImage.tsx"
        ScrollProgress["ScrollProgress"]:::frontend
        click ScrollProgress "https://github.com/karolczaq/portfolio/blob/main/src/components/ScrollProgress.tsx"
        Hooks["Custom Hooks"]:::frontend
        click Hooks "https://github.com/karolczaq/portfolio/tree/main/src/hooks/"
        useMobile["use-mobile"]:::frontend
        click useMobile "https://github.com/karolczaq/portfolio/blob/main/src/hooks/use-mobile.ts"
        useScroll["useScrollProgress"]:::frontend
        click useScroll "https://github.com/karolczaq/portfolio/blob/main/src/hooks/useScrollProgress.ts"
        useStage["useCurrentStage"]:::frontend
        click useStage "https://github.com/karolczaq/portfolio/blob/main/src/hooks/useCurrentStage.ts"
    end

    subgraph "UI Entry Points" 
        Layout["layout.tsx & globals.css"]:::frontend
        click Layout "https://github.com/karolczaq/portfolio/blob/main/src/app/layout.tsx"
        click Layout "https://github.com/karolczaq/portfolio/blob/main/src/app/globals.css"
        Home["Home Page (page.tsx)"]:::frontend
        click Home "https://github.com/karolczaq/portfolio/blob/main/src/app/page.tsx"
    end

    subgraph "Admin UI"
        AdminPage["/admin Page"]:::frontend
        click AdminPage "https://github.com/karolczaq/portfolio/blob/main/src/app/admin/page.tsx"
    end

    subgraph "Backend (Next.js Server)"
        SSR["SSR/SSG Engine"]:::backend
        API1["getProjects API"]:::backend
        click API1 "https://github.com/karolczaq/portfolio/blob/main/src/app/api/getProjects/route.ts"
        API2["getSkills API"]:::backend
        click API2 "https://github.com/karolczaq/portfolio/blob/main/src/app/api/getSkills/route.ts"
        SanityUtils["Sanity Utils"]:::backend
        click SanityUtils "https://github.com/karolczaq/portfolio/blob/main/src/sanity/sanity-utils.ts"
        SanityConfig["sanity.config.ts"]:::backend
        click SanityConfig "https://github.com/karolczaq/portfolio/blob/main/sanity.config.ts"
        Schemas["Sanity Schemas"]:::backend
        click Schemas "https://github.com/karolczaq/portfolio/blob/main/src/sanity/schemaTypes/index.ts"
        click Schemas "https://github.com/karolczaq/portfolio/blob/main/src/sanity/schemaTypes/projectType.ts"
        click Schemas "https://github.com/karolczaq/portfolio/blob/main/src/sanity/schemaTypes/skillType.ts"
        Utils["Utility Modules"]:::backend
        click Utils "https://github.com/karolczaq/portfolio/blob/main/src/lib/utils.ts"
        click Utils "https://github.com/karolczaq/portfolio/blob/main/src/utils/socialLinks.ts"
        click Utils "https://github.com/karolczaq/portfolio/blob/main/src/utils/stages.ts"
    end

    Sanity["Sanity CMS"]:::external
    Vercel["Vercel Hosting"]:::platform
    Static["Static Assets"]:::static
    click Static "https://github.com/karolczaq/portfolio/tree/main/public/"

    %% Connections
    Browser --> SSR
    Browser --> API1
    Browser --> API2

    SSR --> Sanity
    API1 --> Sanity
    API2 --> Sanity
    SSR --> Static

    SSR --> Vercel
    API1 --> Vercel
    API2 --> Vercel

    classDef frontend fill:#E0F7FA,stroke:#006064,color:#004D40
    classDef backend fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1
    classDef external fill:#C8E6C9,stroke:#2E7D32,color:#1B5E20
    classDef platform fill:#FFE0B2,stroke:#EF6C00,color:#E65100
    classDef static fill:#FFF9C4,stroke:#F9A825,color:#F57F17
```
