# tovacinni/research-website-template architecture

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

- Interactive diagram: https://gitdiagram.com/tovacinni/research-website-template
- Repository: https://github.com/tovacinni/research-website-template

## Overview

##### Project type and purpose
- This is a React + Next.js “research website template.”
- It’s effectively a statically-generated or server-rendered front-end site that pulls content from local data files (`src/data/*`) and renders them via React components (`src/components/*`), then is built and deployed via Node/npm and GitHub Actions or Vercel.

##### File structure
- Top-level:
- Configuration & scripts: `package.json`, `next.config.ts`, `tailwind.config.ts`, `tsconfig.json`, `.github/workflows/nextjs.yml`
- Public assets: `public/`
- Source code: `src/`
- Inside `src/`:
- `app/`: Next.js App Router entries (`page.tsx`, `layout.tsx`, global CSS)
- `components/`: Reusable UI components for each section (education, experience, publications, etc.)
- `data/`: TypeScript files exporting arrays of content and their schemas
- CI/CD:
- GitHub Actions workflow in `.github/workflows/nextjs.yml` builds & deploys to GitHub Pages or can be adapted for Vercel.

##### README for additional insights
- Content is fully driven by the `src/data` arrays.
- Customization = editing data files or React components.
- Deploy targets: GitHub Pages (via workflow) or Vercel (automatic).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer Environment
    Developer["Developer Environment\n(Code Editor & Git)"]:::code
    Developer -->|commits code to| Repo

    %% Source Code Repository
    subgraph "Source Code Repository"
        direction TB
        Repo["Git Repository"]:::code
        subgraph "Configuration & Scripts"
            direction TB
            Config["Config Files"]:::code
        end
        subgraph "Next.js App Router"
            direction TB
            AppRouter["src/app"]:::code
        end
        subgraph "UI Components"
            direction TB
            UIComponents["src/components"]:::code
        end
        subgraph "Data Layer"
            direction TB
            DataLayer["src/data"]:::code
        end
        subgraph "Public Assets"
            direction TB
            PublicAssets["public/"]:::infra
        end
        Repo --> Config
        Repo --> AppRouter
        Repo --> UIComponents
        Repo --> DataLayer
        Repo --> PublicAssets
    end

    %% CI/CD Pipeline
    CI["GitHub Actions\n(.github/workflows)"]:::build
    Repo -->|push triggers| CI
    CI -->|runs npm build| Build

    %% Build & Next.js Runtime
    Build["Build (Node.js + npm)"]:::build
    Build -->|reads| AppRouter
    Build -->|reads| UIComponents
    Build -->|reads| DataLayer
    Build -->|includes| Config
    Build -->|outputs static files| Artifacts

    %% Artifacts and Hosting
    Artifacts["Static Site Artifacts\n(.next or export)"]:::infra
    PublicAssets --> Artifacts
    Artifacts --> Hosting

    subgraph "Hosting & Delivery"
        direction TB
        Hosting["GitHub Pages / Vercel"]:::infra
        CDN["CDN"]:::infra
        Hosting -->|serves via| CDN
    end

    CDN -->|serves to| User

    %% End User
    User["End User\n(Web Browser)"]:::infra

    %% Click Events
    click AppRouter "https://github.com/tovacinni/research-website-template/tree/main/src/app"
    click UIComponents "https://github.com/tovacinni/research-website-template/tree/main/src/components"
    click DataLayer "https://github.com/tovacinni/research-website-template/tree/main/src/data"
    click CI "https://github.com/tovacinni/research-website-template/blob/main/.github/workflows/nextjs.yml"
    click Config "https://github.com/tovacinni/research-website-template/blob/main/package.json"
    click PublicAssets "https://github.com/tovacinni/research-website-template/tree/main/public/"
    click User "https://github.com/tovacinni/research-website-template/blob/main/README.md"

    %% Styles
    classDef code fill:#D0E6FF,stroke:#0366d6,color:#000;
    classDef build fill:#FFD8A8,stroke:#f66d0a,color:#000;
    classDef infra fill:#D2FFD2,stroke:#2d9f2d,color:#000;
```
