# codebucks27/next.js-creative-portfolio-website architecture

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

- Interactive diagram: https://gitdiagram.com/codebucks27/next.js-creative-portfolio-website
- Repository: https://github.com/codebucks27/next.js-creative-portfolio-website

## Overview

##### Project type and purpose
- This is a front-end portfolio website built with Next.js (App Router), Three.js for 3D models, Tailwind CSS for styling, and several client-side libraries (react-hook-form, framer-motion, Sonner, Emailjs).
- It’s deployed as a static site with some dynamic capabilities (contact form via Emailjs and live GitHub stats).

##### File structure
- Top level: configuration files (.eslintrc.json, next.config.mjs, tailwind.config.js), static-assets (public/), source code (src/), and standard Node/Next files (package.json, jsconfig.json).
- public/ holds audio, 3D models (.glb), resume PDF—these are served statically via CDN.
- src/app/ uses the Next.js App-Router pattern: each subfolder under “(sub pages)” maps to a route (/, /about, /projects, /contact).
- src/components/ contains all React components organized by feature (models, navigation, about, projects, hooks, etc.).
- No internal database or custom backend: dynamic behavior is achieved via third-party APIs (Emailjs) and client-side requests.

##### README for additional insights
- Confirms that it’s a tutorial “final code” for a creative portfolio, demo link on Vercel, and lists all libraries and 3D models used.
- No mention of a private backend—everything runs client-side or as static generation (SSG/ISR) in Next.js.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global Entities
    Browser["Browser"]:::external
    Vercel["Vercel Platform"]:::platform
    NextJS["Next.js Serverless (SSR/SSG)"]:::internal
    CDN["Static Assets CDN"]:::static
    EmailjsAPI["Emailjs API"]:::external
    GitHubAPI["GitHub Stats API"]:::external
    GoogleFonts["Google Fonts CDN"]:::external
    LucideIcons["Lucide Icons CDN"]:::external

    %% UI Layer
    subgraph "UI Layer (React Components)" 
        direction TB
        HomePage["Home Page<br/>(src/app/page.js)"]:::internal
        AboutPage["About Page<br/>(src/app/(sub pages)/about/page.js)"]:::internal
        ProjectsPage["Projects Page<br/>(src/app/(sub pages)/projects/page.js)"]:::internal
        ContactPage["Contact Page<br/>(src/app/(sub pages)/contact/page.js)"]:::internal
        SubPagesLayout["Sub-pages Layout<br/>(src/app/(sub pages)/layout.js)"]:::internal
        GlobalLayout["Global Layout<br/>(src/app/layout.js)"]:::internal
        GlobalsCSS["Global Styles<br/>(src/app/globals.css)"]:::internal

        Navigation["Navigation Components"]:::internal
        NavIndex["index.jsx"]:::internal
        NavButton["NavButton.jsx"]:::internal

        Models["3D Models Components"]:::internal
        HatModel["HatModel.jsx"]:::internal
        StaffModel["Staff.jsx"]:::internal
        WizardModel["Wizard.jsx"]:::internal
        RenderWrapper["RenderModel.jsx"]:::internal

        Background["Background & Effects"]:::internal
        Fireflies["FireFliesBackground.jsx"]:::internal
        Responsive["ResponsiveComponent.jsx"]:::internal
        SoundPlayer["Sound.jsx"]:::internal

        AboutSection["About Section"]:::internal
        AboutIndex["index.jsx"]:::internal
        ItemLayout["ItemLayout.jsx"]:::internal

        ProjectsSection["Projects Section"]:::internal
        ProjectsIndex["index.jsx"]:::internal
        ProjectLayout["ProjectLayout.jsx"]:::internal

        ContactForm["Contact Form"]:::internal
        FormComponent["Form.jsx"]:::internal

        Hooks["Shared Hooks"]:::internal
        ScreenSizeHook["useScreenSize.jsx"]:::internal

        Utility["Utility"]:::internal
        HomeBtn["HomeBtn.jsx"]:::internal

        DataLayer["Data Layer"]:::internal
        DataJS["data.js"]:::internal
    end

    %% Static Assets CDN
    subgraph "Public Folder (CDN)" 
        direction TB
        Audio["Audio Files<br/>(public/audio/birds39-forest-20772.mp3)"]:::static
        Models3D["3D Models<br/>(public/models/*.glb)"]:::static
        ResumePDF["Resume PDF<br/>(public/resume.pdf)"]:::static
        BackgroundImages["Background Images<br/>(public/background/)"]:::static
    end

    %% Deployment & Routing
    Browser -->|requests page| Vercel
    Vercel -->|serves via Next.js| NextJS
    NextJS -->|renders UI| HomePage
    NextJS --> AboutPage
    NextJS --> ProjectsPage
    NextJS --> ContactPage
    NextJS --> SubPagesLayout
    NextJS --> GlobalLayout
    NextJS --> GlobalsCSS

    Browser -->|loads static assets| CDN
    CDN --> Audio
    CDN --> Models3D
    CDN --> ResumePDF
    CDN --> BackgroundImages

    Browser -->|submits form| EmailjsAPI
    FormComponent --> EmailjsAPI

    Browser -->|fetches stats| GitHubAPI
    ProjectsIndex --> GitHubAPI

    GlobalLayout --> GoogleFonts
    GlobalLayout --> LucideIcons

    HomePage --> Navigation
    AboutPage --> AboutSection
    ProjectsPage --> ProjectsSection
    ContactPage --> ContactForm

    Navigation --> NavIndex
    Navigation --> NavButton

    Models --> HatModel
    Models --> StaffModel
    Models --> WizardModel
    Models --> RenderWrapper

    Background --> Fireflies
    Background --> Responsive
    Background --> SoundPlayer

    AboutSection --> AboutIndex
    AboutSection --> ItemLayout

    ProjectsSection --> ProjectsIndex
    ProjectsSection --> ProjectLayout

    ContactForm --> FormComponent

    Hooks --> ScreenSizeHook
    Utility --> HomeBtn
    DataLayer --> DataJS

    %% Click Events
    click HomePage "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/page.js"
    click AboutPage "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/(sub pages)/about/page.js"
    click ProjectsPage "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/(sub pages)/projects/page.js"
    click ContactPage "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/(sub pages)/contact/page.js"
    click SubPagesLayout "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/(sub pages)/layout.js"
    click GlobalLayout "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/layout.js"
    click GlobalsCSS "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/globals.css"
    click Audio "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/public/audio/birds39-forest-20772.mp3"
    click Models3D "https://github.com/codebucks27/next.js-creative-portfolio-website/tree/main/public/models/"
    click ResumePDF "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/public/resume.pdf"
    click BackgroundImages "https://github.com/codebucks27/next.js-creative-portfolio-website/tree/main/public/background/"
    click DataJS "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/app/data.js"
    click NavIndex "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/navigation/index.jsx"
    click NavButton "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/navigation/NavButton.jsx"
    click HatModel "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/models/HatModel.jsx"
    click StaffModel "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/models/Staff.jsx"
    click WizardModel "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/models/Wizard.jsx"
    click RenderWrapper "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/RenderModel.jsx"
    click Fireflies "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/FireFliesBackground.jsx"
    click Responsive "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/ResponsiveComponent.jsx"
    click SoundPlayer "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/Sound.jsx"
    click AboutIndex "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/about/index.jsx"
    click ItemLayout "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/about/ItemLayout.jsx"
    click ProjectsIndex "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/projects/index.jsx"
    click ProjectLayout "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/projects/ProjectLayout.jsx"
    click FormComponent "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/contact/Form.jsx"
    click ScreenSizeHook "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/hooks/useScreenSize.jsx"
    click HomeBtn "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/src/components/HomeBtn.jsx"
    click TailwindConfig "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/tailwind.config.js"
    click NextConfig "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/next.config.mjs"
    click ESLintConfig "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/.eslintrc.json"
    click PostCSSConfig "https://github.com/codebucks27/next.js-creative-portfolio-website/blob/main/postcss.config.js"

    %% Styles
    classDef internal fill:#cce5ff,stroke:#3399ff,color:#000;
    classDef static fill:#d4edda,stroke:#28a745,color:#000,stroke-width:2px;
    classDef external fill:#fff3cd,stroke:#ffcc00,color:#000;
    classDef platform fill:#e2e3e5,stroke:#6c757d,color:#000,stroke-dasharray: 5 5;
```
