# arshiapazoki/codefolio architecture

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

- Interactive diagram: https://gitdiagram.com/arshiapazoki/codefolio
- Repository: https://github.com/arshiapazoki/codefolio

## Overview

##### Project type and purpose
- This is a Next.js 13 front-end application (no dedicated backend code or database).
- It appears to be an interactive, component-driven site (possibly a portfolio or dashboard UI), built using the App Router, feature modules, shared libraries, and custom “widgets.”
- It is intended to be deployed server-side (SSR/SSG) on a PaaS (e.g., Vercel or Liara).

##### File structure
- Top level:
- next.config.ts, tsconfig.json, eslint.config.mjs, postcss.config.mjs — build and lint configs
- liara.json — deployment config
- tree.js — utility script (generates file listings?)
- src/app/ — Next.js App Router: global layout, head, route groups (home/, timeline/)
- src/features/ — feature-based modules, each with:
- lib/ — hooks or helper functions
- model/ — data-fetching or state hooks
- ui/ — presentational React components
- src/shared/ — cross-feature utilities:
- configs/ — static JSON or TS config data
- lib/ — shared hooks (e.g., time-based)
- src/widgets/ — reusable UI “widget” components (ActivityBar, CodeEditor, Explorer, etc.)

##### README for additional insights
- Bootstrapped with create-next-app using the new App Router.
- Uses next/font for automatic font optimization.
- No mention of backend or database—this is a purely frontend/SSR site.
- Deployment target: Vercel (but Liara config is present).

## Diagram (Mermaid)

```mermaid
flowchart TB
    Browser["Browser"]:::network
    CDN["CDN / Static File Server"]:::network
    NextJS["Next.js Serverless (SSR/SSG)"]:::network
    publicAssets["public/ Static Assets"]:::static

    Browser --> CDN
    CDN --> NextJS
    CDN --> publicAssets
    publicAssets --> Browser

    subgraph "Next.js Codebase"
        subgraph "App Routes & Layouts"
            nLayout["layout.tsx"]:::code
            head["head.tsx"]:::code
            homePage["home/page.tsx"]:::code
            timelinePage["timeline/page.tsx"]:::code
            rootPage["page.tsx"]:::code
            globals["globals.css"]:::code
        end
        subgraph "Feature Modules"
            homeLib["useActiveLine.ts"]:::code
            homeModel["useDeveloperInfo.ts"]:::code
            heroComp["Hero.tsx"]:::code
            homeComp["Home.tsx"]:::code
            timelineComp["ExtendedTimeline.tsx"]:::code
        end
        subgraph "Shared Utilities"
            confHome["homeConfig.ts"]:::code
            confSkills["skills.ts"]:::code
            confTimeline["timelineData.ts"]:::code
            hookActive["useActiveLine.ts"]:::code
            hookTime["useCurrentTime.ts"]:::code
            headComp["CustomHead.tsx"]:::code
            iconComp["TechIcon.tsx"]:::code
        end
        subgraph "Widgets Library"
            widgetActivity["ActivityBar.tsx"]:::code
            widgetCode["CodeEditor.tsx"]:::code
            widgetSoon["ComingSoon.tsx"]:::code
            widgetExplorer["Explorer.tsx"]:::code
            widgetMenu["MenuBar.tsx"]:::code
            widgetStatus["Statusbar.tsx"]:::code
        end
    end

    NextJS --> nLayout
    NextJS --> homePage
    nLayout --> homePage
    nLayout --> timelinePage
    nLayout --> head
    homePage --> homeComp
    homePage --> widgetActivity
    homePage --> widgetExplorer
    homePage --> widgetCode
    homePage --> widgetMenu
    homePage --> widgetStatus
    homeComp --> heroComp
    homeComp --> homeLib
    homeComp --> homeModel
    heroComp --> confHome
    homeModel --> confHome
    homeLib --> hookActive
    hookActive --> hookTime
    homeComp --> headComp
    timelinePage --> timelineComp
    timelineComp --> confTimeline
    timelineComp --> confSkills

    click nLayout "https://github.com/arshiapazoki/codefolio/blob/main/src/app/layout.tsx"
    click head "https://github.com/arshiapazoki/codefolio/blob/main/src/app/head.tsx"
    click homePage "https://github.com/arshiapazoki/codefolio/blob/main/src/app/home/page.tsx"
    click timelinePage "https://github.com/arshiapazoki/codefolio/blob/main/src/app/timeline/page.tsx"
    click rootPage "https://github.com/arshiapazoki/codefolio/blob/main/src/app/page.tsx"
    click globals "https://github.com/arshiapazoki/codefolio/blob/main/src/app/globals.css"

    click homeLib "https://github.com/arshiapazoki/codefolio/blob/main/src/features/home/lib/useActiveLine.ts"
    click homeModel "https://github.com/arshiapazoki/codefolio/blob/main/src/features/home/model/useDeveloperInfo.ts"
    click heroComp "https://github.com/arshiapazoki/codefolio/blob/main/src/features/home/ui/Hero.tsx"
    click homeComp "https://github.com/arshiapazoki/codefolio/blob/main/src/features/home/ui/Home.tsx"
    click timelineComp "https://github.com/arshiapazoki/codefolio/blob/main/src/features/timeline/ui/ExtendedTimeline.tsx"

    click confHome "https://github.com/arshiapazoki/codefolio/blob/main/src/shared/configs/homeConfig.ts"
    click confSkills "https://github.com/arshiapazoki/codefolio/blob/main/src/shared/configs/skills.ts"
    click confTimeline "https://github.com/arshiapazoki/codefolio/blob/main/src/shared/configs/timelineData.ts"
    click hookActive "https://github.com/arshiapazoki/codefolio/blob/main/src/shared/lib/useActiveLine.ts"
    click hookTime "https://github.com/arshiapazoki/codefolio/blob/main/src/shared/lib/useCurrentTime.ts"
    click headComp "https://github.com/arshiapazoki/codefolio/blob/main/src/shared/ui/CustomHead.tsx"
    click iconComp "https://github.com/arshiapazoki/codefolio/blob/main/src/shared/ui/TechIcon.tsx"

    click widgetActivity "https://github.com/arshiapazoki/codefolio/blob/main/src/widgets/ActivityBar/ActivityBar.tsx"
    click widgetCode "https://github.com/arshiapazoki/codefolio/blob/main/src/widgets/CodeEditor/CodeEditor.tsx"
    click widgetSoon "https://github.com/arshiapazoki/codefolio/blob/main/src/widgets/ComingSoon/ComingSoon.tsx"
    click widgetExplorer "https://github.com/arshiapazoki/codefolio/blob/main/src/widgets/Explorer/Explorer.tsx"
    click widgetMenu "https://github.com/arshiapazoki/codefolio/blob/main/src/widgets/MenuBar/MenuBar.tsx"
    click widgetStatus "https://github.com/arshiapazoki/codefolio/blob/main/src/widgets/Statusbar/Statusbar.tsx"

    classDef network fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1
    classDef code fill:#C8E6C9,stroke:#1B5E20,color:#1B5E20
    classDef static fill:#FFF9C4,stroke:#F9A825,color:#F9A825
```
